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OVERVIEW 

INTRODUCTION 

APPLESOFT II BASIC is APPLE'S very much extended &ASTC larguage. BASIC haft 
beeti exCended because there ale aaiiy features on the APPLE II computer ChaC 
just aren't available OTi other cDnputerB that use BASIC, fly adding a few 
new words to the BASIC language, these featutefi are liiiriediately available to 
anyone using APPLESOFT. Amons the features supported by APPLESOFT are 
Apple's color graphics, hlgh-refiolotlon color graphics and the direct analog 
inputs (the game controllers). 

Another feature o£ APPLESOFT is this oiftiiiial. It la not a self-teaching 
manual, eince APPLE provides a sepatste manual [the APPLE IX BASIC 
PfOaraimiiinR Manual ) which will help you learn to prograa even If yoa 
have never touched a computer before. This jnanual assumes that yoti know how 
to program In BASIC and just wtgh to learn Che additioaal features offered 
by APPLESOrr. Chapter 1 (CETTISG STARTED) is a quick run-tlirough of what 
the language hes Co offer. The rest ol the manual is a careful aud exact 
description of every statement In the Iflnguagc and how each stecement uorJtH. 
To help saue yon the Eruatratlon and annoyance that some menuals can cause, 
this manual points out places where programming errors can cause you 
difficulty. Special symbols call your atCCRCion to these polnta- 

The method used to describe APPLESOFT is alnioat a simple language In itself. 

Yeu will find that, after a few mofflents getting used to it, it will apeed 
youi- understanding of e«a.?tlv what Is legal and illegal in the language. 
You will not be left with any nagging d&ubts about the interpretation of a 
sentence, as can happen with pure English desctlptlona. 

Advanced programmers will find this manual especially helpful. Beginning 
pCograiMBera are reminded that they will aoon no longer be beginnerB, and 
will appreciate the extra effort APPLE has made to provide an uniLSaally 
complete manual. To be sure, a thicker manual looks more formidable, but 
when you need the inf onnatlon, you will be glad that we took tha time and 
space to put it ln> 

USING THIS MANUAL 

This reference manual asaumea you have a minimal working knowledge of the 
programining language BASIC. U you're unfamiliar with BASIC, the APFl-E 
11 BASIC FroRramminK Hantial can provide an latroductlon: it covers a 
version of BASIC which ta tauch like APPLESOFT It, but simpler. 

He recoBioend that yow have APPLESOFT 11 BASIC (usually referred to as 
APPLESOFT) up and running when you consult this manual, bo that you can try 
out on your computer anything the manual describes or suggests. If 
APPLESOFT Is running on your system, the APPLESOFT prompt character ( 1 ) 
will be displayed. See Appendix A for an explanation of how to get 
APPLESOFT loaded into your tomputer. 
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Tlinri) nrr two terms you'll need to know when reading this manual. The Word 
"■vnliix" rrt<'r» to the structure of a computer command, the order and 
(iiri^-i-'l fi>riB i>i the command's various parts. The wptd "parse" refers to the 
WAV in which the u-omputer attempts to Interpret what you type, picking out 
tliv viirlouH pnrtB of Che computer commands In order to execute them. For 
AHftiipli', AI'fLKSOFT's ayticaK allows you to type 

Wu'u APfl.lCSUFT parses this Input, it first picks out 11 as the program line 
•tiimhri. tTii-n intt-rprets X5 as an arithmetic variable name. Finally, 
At'l'IV'-i'PT vvflli.iates 3-2 as 9, then multiplies by i, and assigns the value 36 
I 11 I III- uiirLtble whose name is XS'* 

(:hn|>li>r I provider an overview of many APPLESOFT connnands, for chose who 
Imvc hjid llltJe experience programming in BASIC* Many primary concepts are 
till 1 1'diH-rtl, )i«lng examples Chat you can type into the computer. Appendix B 
Hlv.-» [.nliitcra on editing APPLESOFT prograCkS. 

Ilh*> Tiiiiiiilnn Introduced at the beginning of Chapter 2 is used to describe 

AP'n.F.SOFT'H syntax concisely and unambiguously. It will save you time and 

uttnri In iindGTscnndinK how the commands must be structured. You don't need 

r-i imr thJB notation yourself, but it will help you answer many questions 

u^il Mpvr II lonlly discussed In the text. For instance, square brackets ( t 

nnd I ) are uaed to indicate *>ptiOnaJ portions of a command; curly brackets 

< ( jiihI > ) arc used to indicate those portions that may be repeated- So 

(L.KI I C - J 

iHilliAton Ihnt the word LET la optional and may he omicted. And 

tlVti K^liaritrterH 

Imlli <ili'ii that Che REMsTk command conaiscs of the word REM optionally 

till lihUi-iL by one or more characters. 

Ilii- HvntnrcLc abbreviations and definitions in the first part of Chapter 2 
iii>< |irrtifoU"d In a loaicel order for thoae who want to see how we've built 
M|i uiir nyHtem of symbols and definitions. You may prefer to ignore these 
■ ymtii-lii .ind definitions until you encounter one In the text. At that tlae, 
yikii I iiFv n-liT to the alphabetized glossary of syntactic terms given in 
Ajijwndlx N. 

rlioptKrn 3 through l^ present detailed explsnaclons of APPLESOFT'S commanda. 
lliH>itpi<d by subject matter. l£ you're interested in finding out about a 
H|ii>i M Ir ci^mmand, the alphabetized index on the inside of the back cover 
will tir-U you where to look. Additional reference material not covered in 
I hi' I luijiturs can be found In the appendices' 

M SDUD places you'll see the syabol 

IM'i-i i-LlIng a paragraph. This symbol indicates an gnuaual feature to which 
yiii) nhnuld be alert- 

rhv Nymbol 



® 



IvrtnrdfB poragrapliB deBcClblnft Bicyattons from which APPLESOFT may be unable 
In rfftotfur. You will lose your program and will probably have to re-start 
APin.ESUFT. 
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IMMEDIATE -EXECUTION COMMANDS 

Tty typing the following,: 

PRINT 10-4 

and theti prese the key macked BETURN. 

APPLESOFT II will Inioediacely print 
6 

The PRINT ECatcnert you typed was executed aa soon as you pressed the RETURN 
key. APPLESOFT evaluated the farnula after the PRINT and then typed out ita 
value, in this case 6. 

HoH try typing this! 

PRINT l/2,3*Li> 

( * means mulclplyi / means divide). 

When you press the RETURN key. APPLESOFT will print: 
.5 3U 

As you can see, APPLESOFT does division and multiiiltcatlon, as well ae 
subtraction. Note hou a comma ( . ) was used in the PRIHT command to print 
two values in&tead of just one- the use of the comm with the PRINT coiamand 
divides the 'iS-charactcr line Into 3 columns or "tab fields." See the 
dtscuBBion of cab fields In Chapter 6, under Efte PRINT command. 



DEFER RED -EXECUTION COMMANDS 

rniWnniln such as the print statements you have Just typed are called 
"lliliedl»e»-executioTi" commands- There is another Cype of cdnmand called A 
"deferred-execution" command. Every deferred-execution comnaad begtns with 
a "line number". A line tiunber is an integer from to 63999- 



Try typing Ch* follouing lines: 

Iff PR I KT 2+3 

2* PRINT 2-3 

(Eemeraber, each line muat be terminated by 



pressing the RETURN tiey.) 



A sequence of def ef red-execution commands is called a "program." Instead of 
executing deferred-execution statements fsmiediateiy^ APPLESOFT BASIC stores 
deferred-execution coramanda in the APPLE'S memory* when you type RVH, 
APPl.i:sDFT firac executes the atored statement having the lowest line numbef, 
then the atateinent with the next higher line Tiumber, etc., until the 
complete prograra has been executed. 

Suppoae you type RITM now (remember to press the RETURN key at the end of 

each line you type): 

RUN 

APPLESOFT will now display on your TV: 

5 

-1 



J- C 

i- i: 



In ihe previous example, we typed line 10 first and line 20 second. 
Mfiwi'WiT, IL makes no difference in what order you type deferred-execution 
Htatvmuntu. APPLESOFT always puts them into correct numerical order 
■cGoriilng td clieir Line numbers. 

To nee a listing of the complete program currently in memory, with the 

fttnt.vmL'iies arranged in their correct order, type 

LIST 

API'LKKOrr will reply with 

10 I'klNT 2+3 

2tf intlHT 2-3 

Si>fii.-i iofB it ts deslrahle Co delete a line of a program altogether. This ta 
jiccuapliBhed by typing the line nufnbet of the line you wish to delete, 
lollownd only by a press of the BETITRN key. 

Typp the fo] tawing: 

I.I^T 

Al'l'l,l',);orr wUi r*ply with: 

.•9 J'H(IT] Z-3 

YxMj hnvi' now deleted line \9 from the program. There is no uay to get it 
back. To insert a new line 10, just type 10 followed by tile new statement 
ynu wnnt APPLESOFT to execute. 

l/|>i< Ehi' frrUnuldg; 

10 intlKT 2*3 

LIST 

rtl'n.KSUFT will reply with 

ttf l-KINT 2*3 

.•4 mm 2-j 

lh«TH' i» an easier way to replace line 10 than deleting it and then 
liiui'i I lii|^ n mcM line. You can do this by Just typing the new line 1(9 (and 
liH-hitliiK the RETURN key, of course). APPLESOFT automatically throws away 
I hn old line 10 and replaces it with the neu one« 

Tyiie the follot/lng: 

10 PMtHT 3-3 
l.l:.T 

AITl.KSnPT wlU reply With! 
14 PKtNT 3-3 
J4 I'KCHT 2-3 

Ir Ih nnt recnmncnded that program lines be numbered consecutively^ it may 
hi' iii'i-i'itHrtry. later on, to insert a new line between tuo^ existing lines. An 
Lnircmrnt ni 10 between line numbers Is generally aufflcient. 

11 vi»i uiint to crafie the complete pragram currently atored in jnemory, type 
NKW 

If yiiu jire finished running one program, and are about to begin a new one, 
hr miri' to type NEW first. This should be done to prevent a mixture of the 
mid find nou programs. 



Type the EolLoulng: 

NEW 

APPLESOFt vlll reply with the pronqiC character; 

] 

Now type 

LIST 

APPLESOFT will reply with 

1 

showing that your prcvlcms program la no Longer stoced In irienxiry' 

NUMBER FORMAT 

He Hill digress foe a awnept to explain the formac of numbers printed by 
APPLESC?FT BASIC. Numbers are stared internally to over nine digits of 
accuracy. When a number Is printed, only nine itigits are shoun. Every 
nuaber may also have an exponent ta power-oE-ten scaling factor). 

In APPIESOFT BASIC, "real prBcl&leo" (also called "floating point") numberfl 
must be in the range iron -1*11I''3S to 1*1(?"3S, or you risk getting an error 
message- Using addition or &tibtractLon» you may sDmetlnes be able to 
generate ftUBbers as large as l+7*ll?''38 without the error message. A number 
%riioae absolute value Is less Chan a^out J*l0~-39 will be converted to zero 
by APPLESOFT. In addition to these limitations^ true integei: values must be 
in the range from -32767 to 32767. 

When a ngmher Is printed, Che following rules are used to detertnlne the 
exact forma C I 



n 

2> 
3) 



4> 



if the nunber Is negative, a minus sign (-> is printed. 
If the abaoluce value of the number Is an integer in 
the range t to 999999999. It is printed q« an Integer. 
If the absolute value df the number Is greater than or 
equal to .01 and lea* than 999999999.2, the number i& 
printed In fined point notation, with no exponent. 
I£ the numbet does not fall under categorieB 2 or 3» 
scientific natation is used* 



Scientific notation la used to prtnt real precision numbers, enJ ts 

formatted as follows; 

5K.XXXXXXXXESTT 

where each X is an integer to 9. 

The leading S is the 6i|^n of the number, nothing for a positive number and 
minus sign ( - ) for a negative nuiHber. One non-zero digit iS priat?d 
before the decimal point. This is followed by the decimfll point and then 
the other eight digits of the mantissa. An E is then printed {for 
Exponent), followed by the sl^n (S) of the exponent; then the two digits 
(TT) of the exponent Itself. Leading leroes are never printed; i.ei the 
digit before the decimal ia never zero. Also, trailing gemea are never 
printed. 



r-Jt 

r-jc 
r-t 



t ., 



3- C 

1- 4- 

1* 



If there is only one ^i^lt to print after all trailing aecoes are 

Hitppr-CMaed, no decimal point la printed. The exponent sign will be plus ( -I- 
> for positive and minus ( - ) for negative. Tuo digits of the exponent are 
nlWAya printed; that £s, zeroes are not suppressed in the exponent field. 

Hit? value of any number expressed in the form of scientific notation as 
dcKcrlbcd above Is the number to the left O'f the E times 10 raised to the 
power of Che number to the right of the E. 



t\\v lolliHifng are examples oi varloua numbers and the output format 
Al'IM.KiiDn' Will use to print them: 



NIIKHIW 






OUTPUT FORMAT 


*l 






1 


'1 






-1 


hS,' 1 






6523 


-?t.'.fetf 






-23.46 


A'l. JiVJb 






4 S 72090 


l*l»-21» 






lE-cZ? 


-1,'. )'t'>f.?896*l0*l9 


-1.2345679E+11 


1 ntmmw 






1E-HI9 


444i)<l9(t<)9 






999999999 



A nuntiLT typed on the keyboard, at a numeric constant used in an APPLESOFT 
lir.'urflm, nwiy have as many digits aa desired, up to the maxiraum length of 38 
dlgitTt. HowcveTj only the first 1(1 digits *re usually slgniflcentj and the 
t«nth digit is rounded off. 

For example^ if you type 
miKT l.23Ai67876i432i 
AI'PLKStJFT responds with 



COLOR GRAPHICS EXAMPLE 



type 

E'hin will blapk out the top twenty lines of text on your TV screen and leave 
imly >uiir lines of text at the bottom* Your APPLE is now in Its 
l..w-ri'H(>lutlcn "color GRaphlcs" oode, 

Hi)W type 

Ciil.DK - 13 

ArrLKSOFT will only respond with the prompt character: 

I 

ftnd the flashing cursor, but Internally it renembeis that you have selected 

n iv\ low color. 

Knw type 

PLOT 2(1. 2|l 

APPLESOFT will respond by plotting a small yellow square in the center of 

the ai^reen. If the square 13 not yellow, your TV set is not tuned properly: 

adJuHl the tint and color controls to achieve a clear lemon yelt^iw. 



< ■•»«•••« 



nil 



How type 

HLIN (1,31» AT 2fl ^ , 

APPLESOFT wlU drau a horizontal line across the leftmoet chrge-quarters oi 
the screen, qne-quart^r down from Che cop. 

Sav type 

coum. - 6 

to change Co a Tie« color, Aod then type 

VLIN L0,39 AT 30 

You will learn more about coloc GRaptiics later. To get b9Ck co all text 

mode, type 

TEXT 

The character display on the screen Is APPLE'S way of showltiB color 

infomHCion as text- 

When PRIKTlng the answers to problems, Lt is often desirable CO Include text 
along with the answers, Ln order to explain the meaning of the numbers. 
Type the following: 
PRINT '*OSE THIKS IS EQUW- TO", 1/3 

APPLESOFT Will reply wicti: 

OHE THIHD IS EQUAL tO . 131333353 



PRINT FORMAT 

As explained earlier, including a comma < , ) in a PRINT Btatement causes it 
to space over to the next tat field before the value folloutng the comma la 
printed. If we use a semicolon ( ; ) instead of a coinina, the next viilwe 
will be printed iTunedUteLy following the previous value. Try It. 



Try the eolloulng examples: 



PttINT 
1 


I 


,2i 


,3 




FRIHT 


1 


;2i 


;3 




123 










?ilINT 


_ 


1;: 


i-,' 


■3 


-12-3 











The followloR iB an exsmple of a program that reads a value fcoffl Che 

keyboard and unes that value to calculate and print a reauic; 

14 INPUT R 

20 PBIMT 3.14159*R*B 

?10 
314.159 



r- « 

r c 



Hrif»?'ii what happens. When APPLESOFT encounters the INPUT statement, it 
dlaplays a question mark (?) on, the screen, and then waits for you to type a 
iitimhiir. Vrhen you do (in the above example, l9 vaa typed), the variable 
lnlliiwlng INPUT {« assigned the typed value (in this case, the I!JPlilT 
vitrliiblf K was set Co 10). Then execution continues with the ne^Lt aracement 
in the- prograa, whicih Is line 20 In the above example. Uhen the formula 
aflcr the PHlNT statement is evaluated, the value Id is substituted for Che 
variable R each time R appears In the formula. Therefore, the formula 
hBcomcB 3.161^9*10*1*, or 314.159. 

If you haven't already guessed, the program above calculates the area of a 
f Iridic with Che radius R. 

H Wl> Wanted to calculate the area Of Various circles, we could keep 

rt— ruiuiiiiK the pra^rdm for each auccessive circle. But there's an easier 

wny 10 do it, simply by adding another line to the program, as follows; 

)0 GOTO 10 

RltH 

n0 

314.I59 

73 

2&.2 743I 

?4.7 

69.:197;23I 

't 

WKAV. in 10 



Ay giuttlag A GOTO statement oo the end of your program, you have caused It 
III MO bock CO line 10 after ic prints each answer. This could go on 
hull'! Inl tc'ly, but we decided Co scop aCcer calculating the area for chree 
( tri'li'H. Stopping was accomplished by typing a control C (type C while 
hijldlnft dourt Che CTRL key)' and pressing the RETURN key. This caused a 
"htfjik" la Che program's eKecuclon, allowing us to atop. Using control C, 
any program can be stopped after executing the current Instruction. Try Lt 
for yourselft 



VARIABLE NAMES 



Tbii letter R in the program we Just ran was termed » "variable." This ia 

nlmply a mcnory location in Che computer, idenCiCicd by the name R. A 

variable name must begin with an alphabetic character and may be followed 

by any alphanumeric fiharacter. An alphanumeric character ia any letter from 
A ehrough 2, or any digit froci through 9. 

A variable name nay be up to 23A characters long, but APPLESOfT uses only 
tlie lltst two characters to distinguish one name from another. Thus, 
the names G00D6N0UGHT and GOLDRUSH refer to the same variable. 

In a variable natie, any alphanumeric characters after the first two arc 
iRn^rtd unlesfl they contain a "reserved uofd." Certain words used in 



APPLESOFT BASIC commands are "reserved" Eac their specltie purpose. You 
cannot ase these voTds as variable ramca or £■& part of any variable name. 
For Instance. FEND WtJuLd be illegal because END la a reserved word. The 
reserved words In APPLESOFT BASIC ate listed and discussed iii Appendix F, 

Variable names ending in $ or I have a special nieafilng, as dlacuseed later 
in this chapter utider REAL. INTEGER, AKD STRING VARIABIES. 

Below ace some examples of Ugal and llleRal variable names: 
LEGAL ILLEGAL 

TP TO (variable names canfioc 

pSTGS ^^ reserved «ords> 

(;aUNT RGOTO (variable names canooc concatn 

HIS reserved words) 

Besides asslgntii& values co a variable with an INPUT statement, you can alao 
set the value of a variable with, a LET or asaignaient statemetic. 

Try th« Eollowlng examples: 

A - 5 

PRINT A. A*2 

5 l» 

LET Z - 7 

PRItJT 2, Z-A 

7 2 

As can be seen from Ctie exanpleB, the LET is optional In an aBSignmetit 
Bcatenenc* 

BASIC "Temembera" the values that have been assigned to variables using thi& 
type Ot fltatemenc. This "remenberlng" process uses space In the APPLE'S 
memory CO store Che data- 

The values oE variables are throkm away and the apace in memory used to 
score theia Is released when one of four chinas occurs: 

1) A mew line Is typed into the program or an Did line 
is deleted. 

2) A CLEMt command Is Issued. 

3) A RUTS command Is issued* 

4) NEW is typed. 

Here Is another iaportant factJ uncil you assign them B&me other value^ 

all numerte variables are automatically assigned the value zero. Try this 

example: 

PRINT Q, Q+2, Q*2 

2 * 

Another atatement is the REM statement. REM Is short for remark. This 
atacement 1b weed to insert comments or notes into a program. When BASIC 
encounters a REM statement the teat of the llae is ignored. This serves 
mainly as an aid to the programmer, and serves no useful Eunccion oa far as 
the operation o£ the program In Bolwlng a particular problem. 



IF . , . THBI 
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t.(i| 'i wrlt« a progran to check whether a typed number Is zero or not. With 
tho NLatcinc^nts we've discussed so Ear^ this can not be done. What ve need 
Im a ytut^imcnt that provides a conditional branch to another statements The 
|f.»,THi:N statenent does Just that- 

Type MRH» then type this program: 

I ill JKfMST B 

Jit iV Vk - ff THEN GOTO 5> 

Itf rHINT "NON-ZERO" 

r.ll' {MTO 10 

^f^ l-mWt "ZKIIO" 

fiti tunu L|( 

Ulii>n chin pra){ram RUN. It will print a question merle and wait for you to 
1 Vju' (I vnJui? for &. Type any value you wish. The computer will then come 
til ill.)' IK statement. Between the IF and the THEN portion of the statement, 
ttivrr [» nn "assertion," An assertion consists of two expressions separated 
by imi* of the Eollowinft Bymbolsi 

^X ftB"lr HEAJJlMt; 
EQUAL TO 

> GREATER THAN 

< LESS TKAN 

<> or X NOT EQUAL TO 

<• LESS THAN OH EQUAL Tfl 

>• GREATER THAN OR EQUAL TO 

Th» IK ■laCemecit is either true or false, depending upon whether the 
ftusortlon 1b true or not* In otir present prograot lor examplsi if is 
I yirod ri»r B thp assertion Bk0 i.» true* TbeFefore, the If statement Is true, 
•lilt pcoura* execution eontlnues with the THEH portion of the statement! COtO 
\t* Vulliiwlng this command, the committer will skip to line 5(j. ZERO will 
l»« prlnK'd, and then the COTO statement In line bi will send the computer 
hack u> line 10. 

Bilp|>4t»o a 1 is typed for B. Since the assertion B - Is now Ealse, the IF 

■ lat>fiH<nt in false and program execution continues with the neKt line 

nunl>vrt lienor Jng the THEN portion of the statement and any other statements 

In that line. Therefore, NQN^^EHO will be printed and the GOTO In line 4QI 
Will HMiid the computer back to line 19- 

How try Che follouing program for comparing two numbers (remember to type 

WM rimt, Co delete your last program): 

l>tl tNI'llt A.M 

;(l I IK A <» B THEN CatQ 50 

HI l-MCNI "A IS LARGER" 

l.t (-otii Itf 

\t IF A •: n THE!N GOTO B0 

111) I'HIHT "THEY ARK THE SAME" 

ft rtmi 1^ 

HH I'ktNT "H IS LABGEB" 
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Khen tliis program ia Rl™. H^ie ^* "i^l Pi^i'^'^ ^ quesclon roacli and wait for 
VDU to type t«o numbers, separated by a comma. Ac line 2a> if A ts greater 
than fi, A<-B is false and THEN GOTO 5lS l3 Ignored. PrQgram execution then 
aklpa to the statenant Eoilowing ttie next Line mimber, printing A IS LAHeER, 
and finally line id sends the computer back to line Ifl cd begin again. 

At line 2(1, if A has the same value as B, A«-B ie Erne SO THEN GOTO 5fl is 
execuKd, sending the compiJEer tD line 5fl. At line 50, since A has the same 
vaiye as B, A«B is false. Therefore, THEH GOTO Bfl ia ignored and the 
conpucer goes on to the following line number, where it Is told to print 
THE'f ARE THE SAME. Finally, line 79 send the computer hack to the beginning 
again. 

At line 28. if A i» smaller than B, A<-B is true ao program executiari 
continues with tKEN GOTO 50. At line 5fl> A<a Is true so THEN GOTO 80 is 
executed. Finally. B IS LARGER is printed and again the computer ia sent 
back CO the beginning. 

Try running the last two proarams several tlmea. Then try writing your own 
program using the IF.*. THEN statement- Actually trying progcaTDB of your own 
is the qnlckeat and easiest way to understand how APPLESOFT BASIC worlta* 
Remember, to stop these programs just type control C and press REIURK. 



ANOmil} COLOR EXAMPLE 



Let's ti^y a graphics program. Note the use of REM statements for clarity. 
The colott ( : ) Is used to separate multiple Instructions on one numbered 
program line. After you type the program below, LIST it and make sure thai 
you have typed it correctly. Then RWK tt» 

199 GR t REM SET COLOR GRAPHICS MODE 

U0 HOME : REH CLEAR TEXT AREA 

120 X - : Y - 5 ; Bffl SET STARTING POSITION 

1J0 XV - 2 ; REM SET X VELOCITY 

Ue YV - 1 ! REM SET Y VELOCITY 

I SO REM CALCIJLATE NEH POSITION 

t6fl NX - X + XV ; NY • Y + YV 

17fl( KEH IF BALL EXCEEDS SCREEN EDGE, THEN BOUHCS 

130 IF NX > 39 THEN NX - 39 : XV • -XV 

190 IF NX < THEN NX - : XV »■ -XV 

240 IF NY > 39 THEH NY ■ 39 : YV - -YV 

210 IF NY < THEN NY - : YV - -YV 

220 REM PLOT KEW POSITION IN YELLOW 

230 COLOR - 13 : PLOT NX. NY 

21*9 REM ERASE OLD POSITION 

250 COLOR ■ : PLOT X,Y 

260 REM SAVE CURROT POSITION 

270 X - NX :Y - NY 

2S9 REM STOP AFTER 250 MOVES 

290 1 - I + I : IF 1 < 25« THEN GOTO 16tf 

300 PRINT "TO RETURN TO YOUR PROGRAM, TYPE 'TEXT'" 
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Th« command GR tella the APPLE to switch to its color GRaphics mode* Jt 
aUo cleoTS the 40 by 40 plotting area to black, acts the text outpuE to a 
wind'iw of 6 lines of 40 characters each at the bottom o£ the screen, and 
Mi-|[i the next color to be plotted to black. 

HKHK 1h uBed to clear the text area and set the cursor to the top left 
H i.riHT 111 the currently defined tent vindou. In color GRaphics mode, this 
w<>«ild be the beginning of text line 20, since text lines through 19 are 
rtrtw bfing UBcd fot the color graphics plotting area. 

lh*< GOLUR- comiBflnds In lines 230 and 250 set the next color to be plotted to 
(hf vjiliic of the expression following COLOR" . 

Tlw ]'1.0T NX, NY dommand in line 230 plots a small stjuare. In the yellow color 
•Inllnt'ij by the most recent COLOR" command, at Cfie new position Sfjecified by 
i-nr.rfflHlonH NX and NY* RemfiPiber, NX and NY must each be a number in the 
tniiRf through 39» or the square will be off the screen and an error 
im-HUAgL' vlll result* 

SlHlUrly, Pt.QT X,T In line Z50 plots a small square at the paalClou 
>l>K('ir]pd by cxpreaslons X and Y. But X and V «ife simply the '^old" 
i-(i-iirdlnatL>» NX and NY, saved after plotting the previous yellow square. 
Thfirdvrv. PLOT X,Y re-plots the "old" yellow square with s, square whose 
ri.Iiir Irt defined by COLOR- 0. This color is blacky the same color 8S the 
hill liKi'ouiid, BO the "old" yellow square scews to be erased. 

Niiioi Til y,Mt from color graphics back to all text loode^ type 

I t.XT 

iinH tlii'ii prcsfi the RETURN key. 

I'ypliijt 1KXT, aa Instructed, is your escape fron CRaphicE mode* Ignore the 
m inuit'' Hymhals on the screen —• they result from converting your graphics 
.(l«i|iliiy into text characters-. If you don't udderatand line 290, be patient, 
1 1 will l>(' VKplnined In subsequent pages. 

An yoii have Seen, the APPLE II can do more than Just use numbers. We'll 
■tpturn to color graphics again, after you have learned more about APPLESOFT 
IVA»IC. 



FOR . * . NEXT 

Unv advnntriKf of computers Is their ability to perform repetitive tasks. 

KuppDHp we want a table of Square roota, for the integers from 1 Co 10, The 

AI'Pl.KSnPT BASIC function for square root is SqSj the form being 

H4}H(K1 

Mln"ri' K la the ntinber whose square root you wish to cpJcylate. He could 

willc lli« program as follows^ 
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iij 



Itii 



Ifll PRINT 1, 


3CP{1) 


2tf PRINT 2, 


S(?tC2) 


3a PRINT 3, 


SQBOl 


id PRINT ii. 


S(^(4) 


bli PRINT 5, 


SqR(5} 


6(( PRINT 6, 


sqR(6) 


79 PRINT 7, 


sqK(7) 


80 PRINT 8, 


SQR(8) 


9(1 PRINT 9, 


S(?t(9) 


199 PRINT 10. Sqtt(lV} 



This progtao will dP the iab; however, it iB terribly inefllclent. We eati 
Improve the program treraendoualy by using the IF scatement jy8t incroduced, 
as folLowa: 

m H - i 

19 PRINT N, S(ja(II) 
3(1 N - K + 1 

1*9 IF N <- Ii0 THEK GOTO 20 

When this program is BUN, Its output wLll look eitaccly lik^ that at the 
10-staceinent program above it* Lee's look, at how it works. 

In line Ifl, there la a LET Btatement which sets the variable N to the value 
1, At line 20, the computer Is ta\A to print N and the square root of N, 
using n'e current value. Line 28 thus becomes 

20 PRINT 1, S(^(U 

and the result of this calculation la printed due* 

At line 30, there is what appears at first to be a rather unusual LET 
stHtcBient. Hatheraatlcally, the statement B - K + 1 is nonsense. However, 
the important thing to remember is that in B LET statemerii:, the symbol " - 
does not slgTiify eoualicy. In ihle caee " • " tneans "to be replaced with". 
The statement simply takes the current value of N and adds 1 to It- Thus, 
after th« first time chtougii line 30, N becomes Z. 

At line ^9, alnce M now equals 2, the assertion N <- 10 la true so the THEH 
portion sends the computer back to line 29» with N now ac a value of 2. 

The overall result is that lines 20 through 60 are repeatad, each time 
adding 1 to the value N. When K finally equals 10 at line 20, the next line 
will increment it to 11- This results in a fjslpe aBsertlon ac line k^t the 
THEN portion Is therefore ignored, and since there at* no further statement 
the program stops. 

This technique ie referred to as "looping" or "Iteration". Since It 1b used 
quite extensively in programming, there are special BASIC statemenCs for 
using it- We can show these with the following program! 

L0 FOR N - I TO 10 
20 PRINT N, 51^ (N) 
30 NEXT H 

The output of Che program listed above will be exactly the same as the 
output of the previous two programs. 
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At \\n» ■9'. K Is set to equal 1> Line 20 causes the value of H and the 
KqHnri' runt ff K to be printed. At line 30 we see a new type of statenient. 
Ttu- H\X\ N NtnteiDfrLt causes one to be added to N, and then If N <- L0 
|irnKiiim oK'Tiit ji^n goes bsf^k to the statement following the FOR< There is 
iikIIiIiik npi-L-lj^il about the N in this esse. Any variable cauld be used, as 
liiiiK '<" 1 1 la tha »ane variable name in both the fOR ahtl the HEXT 
i.t«ln-niJ>5t«. For instance, zl could be substituted everywhere there is an K 
111 t hi' Above progra* and it would fuacclon exactly the saiae- 

rtit|i|»Mi4> wi- wanted to print a table of square roots for only the even 
laiii'HriH I rum 10 to 20. The following program Would perform this task: 

10 N - L0 

/0 I'KINT N, SgR(N) 

Itf H - N+2 

**il [f K <• 20 TURN GOTO 20 

Kut* thn slnitar structure betveen this, f^rogran and the one for printing 
■i|UHri> rontn for the numbers I to 10. This prograai can also he written 
iiatnK ")*' l^''^ loop Jusc IniCTaduced; 

10 rim N - 10 TO 20 STEP 2 
/0 IHHIi N. £qK(H) 
10 NKXT K 

Nitl li «i lh.it tlii> inajor difference beCueen this progrSQ and the previous one 
KMtMK >''i'H limpH In the addition of the ST£P 2. This tells APPLESOFT to add 
/ li> N 4-ii4-li litsi.', instead of 1 as in the previous program* 1£ no STEP is 
gUt>n Id ji Vm Fitatement, APPLESOFT assumes that one is CO be added each 
t l)H>i Tin- STPP can be followed by any eKpression. 



A program for doing this 



Niiiipnar Wf wjinted to count backwards from 10 to li 
wirnltll hi,' ji!f follows; 

10 I - ]» 
;0 PHI NT I 
10 L - I -I 
h^ rr 1 >- I THKH COTO 20 

Nuilif Hull we arc now checking to see chat I is areacer chan or equal to 

Ih0 (liiJil vnlue. The reason is that We are now counting by a negative 
niiBhvr. In the previous examples it was the opposite, so we were checking 
for a variable less than or equal to the final valuei 

Tin SJKI' Hlaleisent previously Shown tan also he used with negative nuiubers 
tu HI i'>ini|>l iHh this same purpose. This can be done using the same fortnac 
tii»Di1 III the other program, as follows: 

10 Vm I • 1(1 TO [ STEP -1 
;t» I'HINT I 
ll» Nt.XT I 
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FOR loop* can also be "nested". An example of this procedure follows: 

m FOR T - 1 TO 5 
29 FOR J - I ro 3 

39 PRINT I, J 

40 NE5tX J 

Notice chat the NEXT J comes before the NEXT 1. This 18 because the J-loDp 
Is In&tdc of the l-loop. The following program is incdttect; RUN IE and sec 
uhat happeiiis. 

11» FOR I - 1 TO 5 
29 FOR J - ] TO 3 
3(1 PR1M7 I, J 
40 NEXT I 
59 NExn: J 

It does not work because when the NEXT I is encountered, all knowledge ol 
tlie J— loop is lost. 



ARRAYS 

It la often corvenient to be able to select any elemeTiC in fl table of 
numbers. APPLESOFT allows this to be done throuah the use of arrays. 

An array Is a table of nuu1>er&> The name o( this Cable, called the ^rray 
name. Is any legal variable fiane, A for example. The array nsac A ia 
distinct and separate from the simple variable A, and you, could use both in 
the flane program. 

To select an element of the table, we give A a subatrlpt: that ia. to select 
the I ' th elemenEt we encloee 1 in parenthesis (1) and then follow A by thifl 
subscript- Therefore, A(ll Is the I'th element In the array A- 

NOTS: In this section of the manual we will tte concerned with 
ope-dimenslonal arrays only; for additional discussion of APPLESOFT conctands 
relating to array*, see Chapter 5, "Arrays and Strings." 

Ad) Is only one element of array A. APPLESOFT must be told how much apace 
to allocate for the entire array; chat ia, what the maximum dimenBlcos of 
the array will be. This Is done with a DIH statement, using Che format 
DIH A(13> 

In this case, we have reserved Space for the array Index I to go from to 
15. Array subscripts always start at (!■! therefore, in the above example u« 
have allowed for 16 nutnbers In array A. 

tf A(l) is used in a program before It has been DIMensloned, APPLESOFT 
reserves space for II elements (subscrlpta 9 through 11^)* 
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Ah nn (-xsifiple of how arrays are used, try the following program, which sorts 
ji Hut fl 8 numbers typed by you. 

Iljl DtK A(e] : SmCJ^SlON ARRAY HITH HAX. 9 ELEMENTS 

1110 KKM ASK ¥0S. B HUHBERS 

111,1 Ki)k I - 1 TO B 

l,'0 HKlNT "TYPE A NUMBER: "; 

I 19 INPUT A(0 

11.0 Nt:)rr i 

i;9 Km PASS THROUGK 8 NUMBERS, TESTING BY PAIRS 

IfiV F * it : REM RESET THE OBPER ISDSCATOR 

IJ9 VOK I - I TO ? 

IH0 IK A(I) <' A(l+n THEN GOTO 14(» 

t'llt Hm INTERCHANGE AU) AtiQ AU+l) 

.'\f9 T - A{1> 

/III Ad) - AC1+1> 

.'i9 A(l+1) - T 

7j(( r - I : RDf ORDER HAS NOT PERFECT 

Jlt9 NEXT I 

'/•t\/l HRH F - MEANS ORDER IS Pf^tFECT 

it>9 IK F - 1 THEN GOTO 160 ; EEH THY AGAIN 

/J9 I'KINT : REM SKIP A hlHi 

.'H0 KEM PRINT ORDERED NUMBERS 

J^9 KOk I - I TO 8 

300 PRINT A<U 

110 NKXT 1 

Ulion line 90 Is executed, APPLESOFT sets aside space for 9 numeric voltiea, 
A(0) [Jiroiigh A{ai. Lines 110 through l40 get the uRsorted list from Che 
tifKT. The sorting Itself is done in lines 170 throiigh 260, by going through 
ibi. lUt i>l numbers and interchanging any two that are not in order. F is 
il>f "pvrlflct order Indicator": F - L Indicates that a switch was done. If 
..HV wort done, line 260 tells the computer to go back and chec^ some mute. 

II CI roBplete pass is made throuBl^ the eight numbeta without interchanging 
,my 4mcantnR they were all In order), lines 29* through 3l(» will print out 
I ho Horiod list- Note that a aubactipt can be any expression* 



aOSUB . . . RETURN 



AimlliiT iiHcdil pair of statements arc GOSUB and RETURN. If your program 
liprldrmN the- anmc action In several different places, you can use the GOSUB 
a»a KKTURN Htatcaents to avoid duplicating all Che seme Btatemeats for the 
itrtiLm nt each place Within the program. 

\H>i<„ n casUB statenient Is encountered, APPLESOFT branches to the line whose 
ntimjiir lolleius CqS'J&. However, APPLESOFT remembers where it was In the 
piitjit^im bi-fnre It branched. When the RETURN Statement Is encountered, 
An'I.FSoFT gt)L-a back to the first statement following the last OOSUB that wea 
«ix(i<-iiti!d. Consider the following progrsniE 
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T + M 



TRY AGAIH." 



2i( PRIMT "WHAT IS THE 7IBST NtFHBER"; 

^9 cosuB 190 

S« T ' H : REM SAVE INPUT 

5* PRINT "WHAT IS THE SECOHD NUMBER"; 

60 GOSUB 199 

79 PRINT "THE SUM OF THE TWO NUMBERS IS 

80 STOP : HEH EHD OF HAIP PROGRAM 
lt9 INPUT N : REM BECttT INPllT SUBEOUTIHE 
ilfl IF K = INT(H) THEN GOTO 14fl 
i2fl PRIMT "SOBRY, NUMBER MUST BE AN INTEGER. 
130 GOTO 199 

149 RETURN : REM EKD OF SUBROUTINE 

ThIe pros"B a^^s ^^^ '^*'*' numbers which muBt be Inteaets, and then prtnM 
the sun of the cwo. The subroutine in this proRram 1b lines 100 through 
140. The subroutine asks for a nuciber, and If the number typed in reaponec 
is not an Integer, aska for a number again- It will continue to ask utiEll 
an integer value is typed in. 

The main progCara primes UIIAT IS THE FtKST NUMBEH . and thcTi calls the 
subroutine to get the value of the number H. When the subroutine RETURUb 
Cto line 4?K the number that vas typed (N) is saved In the variable T- 
This is done so that uSen the eubronttlne Is called a second time, the value 
of the first number will not be lost. 

WHAT IS THE SECOND KimBEB Is then printed, and the subroutine la again 
called, thia time to gel Che second number* 

When the subroutine RETUSNs the Becotid time tto line 701, THE SUM OF THE TWO 
NUMBERS IS le printed, followed by the value o£ their sum. T contains the 
value of the fitat number that was typed, 
second number- 



eod N contains the value oE the 



The nent statenent In the progran is a STOP staceraent. This causes the 
pcpgram to stop execution 9t line 80. IE the STOP stfiCement were not 
Included at this point* program execution would "fall Into" the aubroutine 
at line tflK. Thla la undesirable because we would be asked to type still 
another number. If we did, the subroutine would try to BETUaN; and since 
there was no GOSUB unich called the subrouticiei an error would occur. F^ch 
COSUB in a program should have a matching RETURN executed later, and a 
RETURN should be encountered only It it is part vt a subroutine which h«5 
been called by a GOSUB. 

Either STOP or END can be used to separate a program from its aubtoutineH, 
STOP will print s taessage saying at what line the STOP was encountered; END 
will teroinate the program without any toesaage. Both corainands return 
control to the user, printing the APPLESOFT prompt character I and a 
Ilaffhing cursor. 
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READ . . . DATA . . . RESTORE 

KitppoMi' you want youT progri^m tc use numbers that don't change each time the 
progrnm Id run,, but which are easy to change if necessary. SASIC contains 
npit4-lAt Htntcmcnts for this purpose^ called Che BEAD and DATA statements. 

i:t>iiiii[der the follouing progrem: 

III I^IHT '*CUESS A NUMBER"; 

^(1 INI'UT G 

H MM) U 

f,lt IK D - -999999 THEN GOTO 99 

Sg IF l> C THEN GOTO 3i* 

I'lt IHINT "tm ARE CORRECT" 

19 KNll 

vi» imNT "SAD GUESS, TRY AGAIK." 

'J'l KKSTOKE 
199 NOTU 10 

IJtf UATA 1,393,-39,28,391,-8,0,3.^,90 
\29 HATA B9.3,I0*IS«-34,-999999 

TlilN Ih what happens when the program Lb RUN: when the READ statement is 
>»n<-itunti'ri:id, the effect Is the same as an INPUT statement, but instead of 
gvtilnft a number from the keyboard, a number is read from the DATA 

■ t at nmeiits- 

riir flrnt time a nunber is needed for a READ, the first number In the first 
DAIA ntaleinant is returned* The second titae one Is needed, the second 
•lumlH'T ii! the first DATA statement is returned^ When the entire contents 
nt Ihi' first DATA statement have been read in this manner, the second DATA 
■iMtPlM'nt will then be used. DATA is always read sequentia tly In this 
Mnnor, and there may be any number of DATA statements In your program. 

Thit pnrpi>ae of thlg prograw Is to play a little ^ame in which you try to 
ttiiKkH one of the nupbers concalneiJ in the BATA staceaents. For esch guesB 

■ hat Ih typed in, the couputet reads through all of the numbeire In the DATA 
tilfltvintriiLa until It finds One that matches the guess. If REAP retuCnS 
-VM'9^9Si, oil of the available DATA numbers have been used, and a new guess 
HiiMt bi- Bwide. 

Hrlur*? going back to line 10 for another guess, we need to make the READ 
Iii'kIii with the first piece of data again. This is the function of the 
KKHTOHK. After RESTORE is encountered, the next piece of data ROlD will 
aiialn be the first item in the first DATA statement. 

DATA itateDenCa nay be placed anywhere within the program. Only READ 
Htatnncnts make use of the DATA statements in a program, and any other time 
tfioy mro encountered during program ejceentlon they wtU be ignored. 
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REAL, INTEGER AND STRING VARIABLES 

There are three different types of variables used In APPLESOFT BASIC So 
Ear we have just used one type — real precision. Numbers in this mode arc 
displayed with up to nine decimal digits ot accuracy and ttsy range up to 
approximately IS to ct>e 38tK power* APPLESOFT converts your numbers from 
decimal to binary for ICs tntemsl use and then back to decimal when you ask 
It to FHlHT the answer* Because of toufidlng errors and other 
uTiprcdictablea, internal Oiath routines such as square root, divide* and 
exponent do not always give the exact number that you expected. 

The number of places to the right of che decimal point may be s*t by 
rounding off the value prior to PRlMTitig It. The general formula for 
accomplishing this Is: 

X - IHT(X*H(-Dt.5J/INTClflTl+.5) 
In this case, D is the nwraber of decimal places. A faster way to set the 
number of decimal places is to let P^'HJ'T) and use the formuU: 

X - IBT<X*P+.5)/P 
where P-l* is one place, V-^199 ts 2 places, P-LW0 ia 3 places, etc. Th& 
above works for X>-1 and X<999999999. A routine to limit the number of 
digits after the decimal point ia given in the next section in this chapter. 

The table below Bumroarlzes the three types of variables used In APPLESOFT 
BASIC programrningc 

Oescriptlon 

StrlngH 

<0 to 255 charactersj 

Integers (muBt be In range 
of -iiJbl to +32767) 

Real Precision 
CExponent -38 to +38. 
with 9 decimal digits) 

An integer or string variable muat be followed by a X or S at each use of 
that variable. For example, X, XI and XS are different variables. 

Integer variables are not allowed In FOR or DEF atatements* The greateet 
advantage of Integer uariables is their use in array operations wherever 
possible, to save storage space. 

AH arithmetic operations ace done In real precision* Integers and integer 
variable valyes are converted to real precision before chey are used in a 
calculation. The functions SIN, COS» ATN. TAH, SQR, LOG, EXP and HMD also 
cdfivert their arguments to real precision and give their results as such. 

When a number t& converted to an laleger, it is truncated (rounded down). 

For example: 

U-.999 AJ— ,01 

MIJNT H PRINT AI 

-1 
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AS 
ALPHAS 


% 


CIX 


none 


C 
BOY 




J=:C 



.• I 
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l( you aHBlgn n real nunber to an integer variatile, and then PRINT che value 
of til* Integer vBrlable, it is as If the iNT function had been applied. No 
g mowit Ic conversion Is done between strings and numbers: assigning a 
nu«htfr to a Ktring variable, for instance, results in an error message. 
Ihiwi'vrr. IhiTu iire special functions for converting one type to the other. 



STRINGS 



A iiiM|iicnt-L-' itf characters is referred to as a "literal". A "string" Is a 

IIUTJil vnx-losed In quotation marks. These are all strings: 

"HI I.I." 

"AI'Cl.K" 

"Til 11 IS A TEST" 

|.|h4< niimiTlic variables, string variables can be assigned specific values. 

MtltiK vjirlnbleB are distinguished from nunierlc variables by a $ after the 

UHil' tikhli- iwitni-'. 

fiM i>xiimp]>i<, I ry the following: 

AV - "um) HORNINC" 

fU I H I A ^. 

I.IHIII KiiKNIHr. 

■ ill I til u t'xJiBple, ue set the string variable AS to the string Value "GOOD 

►HIBKirii;". 

Hiiw Hint wo have set A$ to a string value, we cap find out what the length 
iif ihln vnliic Is (the number of characters It contains]. We do this as 
(>>l 1>>wi>r 
I'illNr l.l;N(A$K LENC'YES") 



Hill liiN luiK'tlon returns an integer equal CO' the number of ch^racterv In & 
■irUiHi Its tSNgth. 

11i»> niimhtT at rhnracters in a string expression nuay range from f} to 255^ A 
mMLhk whiih contains 9 characters is called a "null" string. Before a 
■ liliiM vjirlnbU- Is set to a value In the program., it is initialized to the 
hmI I ulrlMji, IttlSTIng a null string on the terminal will caus« no 
I bill <ii t <>rH to h-t printed, and the cursor will not be advanced to the next 
>>iltin>ii. Try tUv following: 

I'HiNi ir.ii(ii$]; q$i 3 
HI 

Anti||i»r way to create the null string is to use 

in - "" 

(•■ Hid v(|utvnle<nt statement 
liD-l U? - "" 

Hull Inn II HlrhiR variable to the null string can be used to free up the 
nl I liiH *pin:v unL-d by a non-nuU string variable- &ut you can get into 
iniHhlii annlKnlng the null string to a String variable, as dlscus&ed in. 
DhNplvr ' under the IF stateiqent' 
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0£teii it Is il«»ltablf! t^ retrieve pgrC of a string and nianlpulate It. Now 
that Me have Set A$ to "GOOD HORNING", ue might wane Co print out only the 
f Irst four characters of AS. 
Ue uould do GO like chls: 

PRIHT LEFTS(A5»4) 
GOOD 

LEFTS (A$,H) Is a string function wlilch returns a substring compad-ed of the 
leftmost H characters o£ its scrlng arguiBenC, A$ In this case. Here's 
another exatspLe: 

FOR N - I TO LEH(Ag) ; PRIST LEFTSfAS.H) : HEXT M 

Q 

GO 

000 

GOOD 

GOOD 

GOOD M 

GOOD MO 

GOOD MOR 

GOOD MORN 

GOOD MORNl 

GOOD HORN IN 

GOOD MORNING 

Since AS hss 12 characters, thila loop will be executed with N-l, 2^ 3,.->„ 
lit 12. The first time through, only ttie first ch^Eact«r ulU h^ printed; 
the second time the first t«o chafacCcre will bc prlOCH, et.c. 

There is another sttlng function called RIGHTS^ RICH75(A$,N> returns the 
rlghtmosC K characters frora the string expreBsion A$. Try a^batltutina 
RICHtS for Le?TS In the previous escample and aee uhat happens. 

There' Is also a string function which allows us to take characters Efom Che 
nlddle of a string. Try the following: 

FOR N - 1 TO LEN<A$) : PRINT HID5(A9,N> i NEXT H 

MIDS(AS,K) roturns & substrli^g starting at the Nth position ai A$ to the end 
(last character) of A$, The first position oE the SCrltlg is position I and 
the tast possible position of a string Is position 253. 

Very often, it is desirable to extract only the Nch character from a string* 
This can be done by calling H1S$ with three arguments: HIDS(A5>N,, 1 ). The 
third argumtne specifies the number of characters to be returned) 
beginning with character N. 




l-'or t'x.inple; 

H1R H-1 TO LENCASJ.-FRINT HIDS(A$,N, I ) , HIDS (AS,N,2):NEXT U 

c. ca 

O 00 

II OD 

II D 

M 

M MO 

OR 
M KS 
N NI 

1 IN 
N NG 
C G 

Spo Chnpter 5 for more details on the workings of LEFTS, RIGHTS and Mtl&S. 

ThCrlngM may also be concatenated (put or Joined together) through the use of 

tlif pluB ( + ) op«iracor- Try the fDllowliCig: 

H$ - AS + " " + "BILL" 

I'KirfT BS 

hiilH) MlffiHlNC BILL 

C;r.iiratenatJon is especially useful it you wish to take a string spart and 
Ihi-n put It bftck together with slight raodif icatlons. For Inatancei 
CS - IIU;HTS(BS,3) + "-" + LEPT5{B§,4) + "-" + MIDS(B$,6.7i 
PktHT CS 

iin.L-<;iHin-fiiORi*iHG 

SiiKiiM kttu-N it Is desirable to convert a number to its string represents tloti 
mid v)cr-vi-fHe. The functions VAL and 5TKS perform these taaka. Try the 
I III liiwIriK! 
SIKINCS - "i67.B" 
I'KINT VAL(STH1NG$) 

liTKIHGS - STBSf3.Ul5) 

miNT STRINGS^ LEFT$(3TRING$, 5) 

M4H 3.U1 

riiv :tTRS (unction can be used to change numbers to a certain format for 
Itipiii nr output. You can. convert a number to a string and then use LEFTS. 
RHJITSt MIDS and concatenation to reformat the number sa desired. 
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The iollowlng short program detBonstraces how sCring CuncClonS may be used to 
£ormac numeric output; 

IM INPUT "IVfE ANY NUMBER: "; X 

Ufl PRINT 1 &EM SKIP A LINE 

]29 PRINT "AFTER CONVERSION TO REAL PHECISIOS," 

IJfl INPUT "HOU MANY DIGITS TO RIGHT OF DEClHAi.? "; D 

14(1 COSUE IftH 

158 PRINT "*»*" : REM SEPAHATOR 

L6I? GDTO L00 

laOtf XS - STa$(X> : REM CONVEIT INPUT TO STRING 

mm REM FIND POSITION OF E. IF IT EXI&TS 

1020 FOB I - I to LEH<>:S) 

IflSfl IF MrD$(XJ,l,i) <> "E" THES HEXT I 

IQilfl REM I IS NOW AT EKPOHENT PORTION fOU END) 

1050 REM FIND POSITION OF BECIMAl., IF IT EXISTS 

1060 FOR. J - 1 TO I-l 

1070 IF HID5(XS,J,1) <:> "." THEN NEXT J 

1060 lOl J IS NOW AT DECIMAL (QR END OF NUMBER PORTION) 

1090 HEM DO D DIGITS EXIST TO RIGHT OF DECIMAL? 

1100 IF J+0 <*• l-I THEN N - J^O ! GOTO U 30 ! REK YES 

1L10 N - I-L : REM HO, SO FRlKT ALL DIGITS 

1120 REH PRINT KUHBEB PORTION AHIJ EXPONENT PORTION 

1130 PRINT LEFT${X3,N) + HIDSCXS.l) 

I 140 RETURN 

The above program uses a subroutine starting at line 1000 to print out a 
predefined real variable X truncated, not rounded olt , to D digits after the 
decliwl point. The variables XS^ I and J are used In the subroutine as 
local variables* 

Ltnc 1000 converts the real variable X co string variable X5- 
Lines 1020 aod I03fl acan the string to See If OP E la present. I le set to 
tbe position of the E, or to LEN^XS) + I If tio E ia there. Lines ISfiS and 
107B search the string for a decimal point. J is eet to the poeitlon of the 
decimal pdlntT or to l-l ii there is no declfflsl. 

Line 1100 teats whether there exist at least D diftits to the rie^it of the 
decimal. If they do enist, the number portion of the string must be 
truncated to length J+0, which Lb positions to the right of J, Che decimal 
position. The variable N Is set to this length. 

If there are fewer than D digits to the right of the decimal, the entire 
nunber portion duty be used. Line 1110 sets the variable N to this length 

Finally, line 1130 printe out variable X es the concatenation of cuo 
Bub-strlngft. LEFTS(XS,N^ returns the signlflcaot digits of the number 
portion, and HIDS(Ji$il> ceturns the exponent portion, Lf It was thete. 

STRS can also be used to conveniently firtd out how many prlnt-poaltlons a 
ntinher will take. For example: 
PRINT LEN(STR5(33333. 157)) 
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II vi^u havi^ an application irtiere a user is typing a question such as 
WHAT l-S THK VOLUME OF A CYLINDER OF RADIUS 5.36 FEET 

Mil) HKIGIIIT ^. 1 FEET? 

yiiiL I'Jiii use the VAL function co extract the numeric values 5. 3& and 3.1 from 

the iigiieul. Ion. Additional information on theee functions and CltR^ &Tid! ASC Is 

III CltiijitL-r 5. 

Tlo- I'll lowtng prog.ram sorts a list of string data and prints out the 
dlphabetlncd ILsti This program is very similar to the one given earlier 
for •ortlrt^i^ a numeric list. 

100 IIIM AS(15) 

tl0 HIK 1 - I TO 15 J READ A${I) i NEXT 1 

i;i,l I- - a : I - I 

110 IP AS(I1 <- A$<I+U THEN GOTO 160 

L'.0 rs - AS(1+1> 

IV0 ASll+n ■ AS(1) 

Lh0 ASdl - TS 

1 1^0 r-i 

LH0 I - 1+1 : IF t <- 15 THEN GOTO 130 

I'l0 U F - I THKN CflTO 120 

/00 II* I - I TO 15 : PRINT ASd) : NEXT I 

.'JH ItATA APPLE, DOG, CATjRANDOH.COKPOTER, BASIC 

.' 10 IPM'A H^l^fUAY,""*•AKSWER***",*•FOOl " 

,'ft0 liAIA G(mfUTHljPOO,ELP,MlLUAUlC£E,SEATTbE,ALBl!qUEil;qUE 



MORE COLOR GRAPHICS 



III IWK (iri'vloutL examples, we've explained hou the At^PLE II cati do cooler 
ItriipliJ^i ^> Jift WL-I I as text. In GRaphics mode, the APPLE displays up to 160? 
anal) »(|ijJirt-8. (n finy Qt )6 possible colors, on a 40 by 40 grid. It also 
ixri'vldi'ii h lines of text at the hottOn of the Screen- The horizontal or 
n-«xIh Im HtJindard. with the leftmost position and 35 the rightmost. The 
vvrl lr<il or y-axls is non - standard in that It is inverted: i is the 
tiui wHBt piiultlon and 39 is the bottoma ost . 
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20 


HOME 


30 


COLOR 


40 


LIST 


^0 


COLOR 


$0 


HOHE 


70 


COLOR 


B0 


HOHE 


90 


COLOR 


109 


HOME 


110 COLOR 



10 CR : SEH I»1TIAL1ZE COLOR CKAFHICS; 
SET '^0X40 to ELACK. 

SET TEJCT WINDOW TO l* LINES AT BOTTOM 
: REH CLEAR ALL TEXT AT BOTTOM 

= 1 : PLOT 0.0 i REH HAGEWTA SQUARE AT 0,0 
30 : GOSUB 1000 

- 2 : PLOT 39.0 : REM BLUE SQUARE AT X-39,Y«0 
: LIST 50: COSUB 1000 

- 12 : PLOT »,39 i HEM CREEK SQUARE AT X=0,f*=39 
: LIST 70 : GOSUB 1000 

- 9 ; PLOT 39,39; REM ORANGE SQUARE AT X-39,Y-39 
: LIST 90 X GOSUB 1000 

- 13: PLOT 19,19: REM YELLOW SQUARE AT CENteS 
OF SCREEN 

120 HOME ; LIST 110 ! C^SM? !000 

130 HOME : raiNT "PLOT YOUR OWN POINTS" 

1&0 PRINT "REHEHBER, X i Y MUST BE >-0 & <-39" 

150 INPUT "ENTER x,ir; "; x,y 

160 COLOR - 6 ; PLOT X,Y i REH BROVH SQUARES 

170 PHlHT "TYPE 'CTRL C AJn> PRESS RETURN TO STOP" 

180 GOTO 150 

1000 PRINT '•***HII ANY KEY TO CONTIBUE***"; : GET A$! RETURN 

Afcer you have typed tJie program, LIST It and check lot typing errors. You 
aay uaot to SAVE it on cassette tape for future use. Then RUN the program* 

file command Gft tells APPLE to switch CO Its color GRaphlce mode. 
The COLOR cominand eeCS Che ne«t COloc to be plotted. That color remains act 
until changed by & new COLOR coirtcaaiid^ For example, the color ploCted in 
line 160 reDtains the aame no matter how many points are plotted. The value 
of the expression folloHlng COLOR niust be In the range to 255 or an error 
may occur. However* there are only I& different colors, usually numbered 
from thtoygh 15. 

Change the program by re-typlng lines i50 and 160 as follous: 

1S0 INPUT ''ENTER X, Y, COLOR: "; X, Y, Z 
160 COLOR - Z: PLOT X,Y 

Now ROH the program and you will be able to select your own colors as uell 
as points. He will dcmonetfate Che apple's color ranae in a moment. 

The PLOT X,Y command plots a small square of color defined by Che laat COLOR 
comtnaind at [he position specified by expressions X and Y* Remember, X and ? 
mU9t each be- a number In the raTig,ie through 39> 

The GET iRSCiructiOTi In Une 1000 is similar to an INPlfT instruction. It 
waits for a single character to be typed oti the keyboard, and aoeigns that 
character to the variable fQllovrlng 'CET* It Is not necessary CO press the 
RfTURN key. In line 1000, CET A$ is JtiBC used to Stop Che program until any 
key is pressed. 

Remenbei:: To get from color graphica bacfc to all text mode, type 

TECT 

and then press the RETUBN hey. The APPLESOFT prompt character will then 

reappear* 
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typ* the following prograffl aad RUN It to display the APPLE'a range of colors 
(reaembec to type KEH first). 

]0 GR ; HW6 

20 FOR 1 - TO 31 

]0 COl-OR - 1/2 

i'.0 V1.IN 0,J9 AT I 

S0 NEXT I 

f.0 FOR I - TO 14 STEP 

70 PRINT 

M0 FOR 1 - 1 TO 15 STEP 



PRINT TAB(I*Z + I); I J : NEKT I 
PRINT TAB(I*2 + 1); I; : NEXT I 



"40 PRINT : PRINT "STANDARD APPLE COLOR BARS"; 

Li:iliir bate are displayed at double their normal width. The leftmost bar is 
blni-k as set by COLOB'*0i tb« rightmost, white, is set by COLOR^IS. 
Da-pendling on the tint setting on your TV, the second bar as set by ^OLOH-I 
will be magenta (reddish-putple) and the third (COLOR-2) will be dark blue. 
Adjust your TV tint cOTiCf<?l for theee colors- lo Europe^ color tints may be 
dlflt-rent. 

In the last program a conimand of the form VLIN Yl, Y2 AT X was used In line 
40. IhlH command plots a vertical line from the ycoordiinate specified by 
vxpri'iiSion yL to the y-eoordlflate specified h)/ expression Y2, at the 
liiirlcontnl position specified by expression X. Yl, Y2 and X must evaluate 
til vnlwcs in Che range through 39. Y2 may be greater Chan, equal to, or 
MittnlU'r than YL* The command HLIN XL, X2 AT Y is similar to VLIN except 
thai it plots a horizontal iLoe. 

Hate; The APPLE draws an entire line just as easily 
as It plots a siagle poJntJ 



HIGH-RESOLUTION COLOR GRAPHICS 



K<iw that you are familiar with the APPLE'S low-resolution graphic^, you will 
find chac understanding hlgti-resolutloo graphics is easy. The coinmancis have 
ii Hlmllar appearance: usually they are formed by just adding an H {ior ^igh 
ronolutlon) to the Ones you already know. For instance, the command 
IICK 

nt!tH high-resolution graphics mode, clears the high-resolution screen to 
bLiiL-h, itnd leaves t* lines for text at the bottom of the screen. In this 
dkiiLp, you are plotting points on a grid that Is 280 x-positlons wide by 160 
y-poaltions high. This lets you draw on the screen with much more di^tall 
than the 40 by ^0 grid of low-resolittion graphics. Typing TEXT returns you 
to the normal text mode. 

In addition to Che HCR screen, there is also a second hlgh-reaolucion 
icredn you can use if your APPLE contains at least 24K bytes of memory. 
High-r»'Holutlofi graphics mode for the "second page" of memory is invoked by 
I III' cumnnnd 
K(»2 

ThLH cLears the entire screen Co black, giving you a plotting Surface that 
la 2H0 x-positlons actoss by 192 y-positlons high, and no text St Che 
botta*. Again, type TEXT to see your program. 
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Sound wondertul? IC Is; but you do liave to make some sacrifice for this 
new ability: there are Eewer colors. THe color for hlgh-re&olution graphics 
Is set by a command o£ the form 
HCOLOR - N 

uheire N is a number from 'i (black) to 7 (white). See Chapter B for a 
complete Hat of the colors jjvaiiable. Because of the construction of color 
televisions^ these colors vary from TV to TV and from One plotted line to 
tht nexr. 

Flnallyi there is one easy Instruction for all plotting In hi^h-resoluEion 

graphics. To see this in actloni type 

HCOLOft - 3 

HGR 

HFLOT 139, 10(1 

The laat comiaand plots a higb-resoiutlon dot In the color you set «ith 

HCOLOR («hite} at the point x-130, y-lflfP. As in low-resolution graphics, 

x-fl is at the left edge of the screen, increasing to the rl&ht; jr-0 Is at. 

the top of the screen. Increasing dounward . Haxitnuin value for % Is 279; 

gLaKlTnum y Ib 191 (but in HCS's mixed graphicE-pltis-text modO), y values are 

only visible down to yl39). 

Now type 

UFLOT 2(1,13 rO U5,S0 

Like toaglc, a white line Is drawn from the point x-20, y-15 Co the paint 

X"1A5, y"8(l. HPLOT can draw lines between any two points on the screen — 

hoilaontat, vectical. or any angle. Do you want to connect another Hn* to 

the ■end oE the previous one? Type 

HPLOT TO 12,80 

This form of the comnjsnd takes its starting point from the last point 

previously plotted , and also takes its color from that point {even IE 

you have issued a new HCOLOR command since Ibat point was plotted)* You can 

even "chain** these coianande in one InstCMctloa- Try this: 

HPLOT P.* TO 279,0 TO 279,159 TO lJ,I59 TO 0.B 

Vou should now have a white border around ail four aides of the screenl 

Here's a program that draws pretty "moire" patterns on youc screen; 

SO HOME t REM CLEAR THE TEXT AREA 
100 VTAB 24 : RQI HOVE CURSOK TO BOTTOM LINE 

120 HOt : REM SET HlCtt^ESOl.UTlON GRAPHICS MODE 

U0 A - RND(1> * 2 79 : REH PICK AN X FOR "CENTER" 

160 B • RHD(l) * 159 : BEH PICK A Y FOR "CENTER" 

180 XX - (ftnD(n * 'i} + 2 : REH PICK A STEP SIZE 

200 «TAB 15 : PRINT "STEPPING BV "; 11; 

220 FOB X - TO 278 STEP 11. i REH &TBP THRU X VALUES 

2't0 FOB S - TO I ! RSi 2 LINES, FROM X AND X+1 

260 HCOLOR - 3 « S : REH FlBST LINE BLACK, NEXT WHITE 

280 REM DRAW LIKE THROUGH *'CEN1ER" TO OPPOSITE SIDE 

300 HPLOT H+St0 TO A,B TO 279-X-S,159 

S20 NEXT S, X 
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1^0 FOH y " TO I5B STEP 11 : REM STEP THRU Y VALUES 

Jh0 ft* S - TO 1 r REH 2 LINES, FROM Y AND Y+1 

tH0 llCn[J3R -3*5: REM FIRST LINE BLACK, NEXT WHITE 

/.00 KHl DRAW LINE THROUGH "CENTER" TO OPPOSITE SIDE 

'..■0 HPLOT 279, ¥+S TO A,B TO 0,159-Y-S 

^.'.0 NKXT S. ¥ 

!M KC<B PAUSE - 1 TO 1500 ; NEXT PAUSE ; REH &ELAY 
!,m GdTO L20 : REH DRAW A NEW PATTERN 

TlilH fN a rather long program; type it in carefully and LIST it in portions 
(LIST (1,320 for ini&tance) to check yOur typing. We've added a Space between 
mane Iln4.-H to make the program easier to read. Ydur LlSTing. will not fihou 
tliuHf spaces* When you are sure It is correct, RUN the program. 

VTAB mid bn'AB are eursor-taovlng eommanda, used to print a character at a 
(rri'-'fliHrrniioed pos^itton on the text screen. VTaB 1 places the cursor In the 
liip llnt!i VTAB 24 places it In the bottom line. ETAB 1 puts the cursor ta 
lIh' If^ft mLiut position on the current 1 Inej HTAB ^0 puts it in the rlK^itmost 
piinlUon. In d PRiNt instruction like the one at line 200, you nay need & 
I I rinl H«*nlrolon to avoid a Bub&e^uent '"line feed" that dlBplacea your 
mi' N Nana. 

Ihei lunrtlon RND(N}, where N Is any positive nufflber, reCurtie. ft tEndooi number 
III fhe riiuRf from to .999999999 {see Chapter 18 for a complete discuesloo 
M KN[l>. Thus line 1S0 assigns to the integer variable IX & random nutnber 
Irxm 2 In "> <,a number is alvays rounded down uhen it is converted to an 
LiilrK«'fl- The STEP aize In a FOR.. .NEXT loop does not have to be an 
liilrK<'r« lo*! it inay be easier to predict the results for an integer STEP* 

Ah you saw In lines 3'20 and ^A0, one inatruccion can provl<)e the N£^ far 
mitrn than onu FOR statement. Be careful that you list the NEXT variables in 
I ho rts^it order, chough, to avoid crossed loops* 

I Inn 460 Ih Just a "delay loop" that gives you a moment to admire one 

|iiill<-rii hi-fori- the next ooe befcliiQ. Each time line fiSU Sends the computer 

bill k III l\iv 1K;R coDimand In line 120, HGR clears the screen for the next 
|)ii( Lvrn* 



Til gii baih to programming, 

rtrl c: 

■ltd I han typ« 

T*trr 



atop the pattern by typing 



ian yiiu think of ways to change the prograia? After SAVEIti^ this uersicn on 

yniii canKt'itu recorder or disk, try naking the value of HCOLOR change 

mndowly. Try drawing fltBt white, then black llnesn or only White lin>e6i 

JIAITV PKOCHAHMINCI 
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CHAPTER 

DEFINITIONS 



it SynEocClc »efinltion& and Abbreviations 

^^l Rules for Cvaluaclng Expressions 

36 Coiivi>rBlrin of Types 

36 CKOcutton Hodes 



SYNTACTIC DEFINITIONS AND ABBREVIATIONS 

(For an alphabetic List oE these def inlcione, see AppendLn H) 

The folSoHlng deEinltlons use gecaevmbolg such as < and \ -- charoctera 
used to unamMftoously indicate structures or relationships In APPLESOFT. 
Th* mecasymbolS ^re not part oi APPLESOFT. In addition to the ttu* 
Mtasyi^bols. Eh^ special syfl-bol :- icdlcateB Che beginning of a coxapleti. or 
partial definition at the tero that Is to the leEt of :- 

i :- metasyiflbol uaed to separate alternatives 

(note: an item may also be defined fleparately 

for each alternative) 
[1 t- metasymbols used to enclose material which 

is optional 
{ > :- netasymbols uaed to eocloBe material which 

may be repeated 
V ;= mccasymbol ysed to eocloae matetlal whoae 

walue Is tii be used: the value of x 

is written \x\ 
:- metasymbDl which indicates a required apace 

tn?t a symbol 

loHcr-casc letter 

:- a|b|c|d|eil|Blh|ilJ|k|l|«lnloip|q|r|s|tW[vitf|xly|z 

neca symbol 

:- lower-caee letter 

digit 

:- I|2p|4|i1617|&|9l0 

metananie 

:- <wet»ByBibol> [digit] 

metasymbol 

!- a slrtale digit concatenated to a metanatfie 

special symbol used by APPLESOFT II 
:~ special 

specinL 

:- ii*isixi6i'unhi:i-i-i?i+uin/i>M<i»nn" 

Control characterB Ccharacters which are typed 
uhlU holding down the CTRh key) and the null 
chafflCter arc also speclaU- APPLESOFT uSCS the 
right bracket ( ] ) only for the prompt character; 
In this document it Is Msed as a metaayiBbol. 

"^^^^^ A|B|ClD|E|FlC|H|l|J|K|L|M|S|0|P|Q|R|S|T|U|V|H|XiY|Z 

character 

:•■ letterldiglctspeclal 










letter ({letter I dig 
A name inay be up 
When dlatlogu^shl 
Ignores any alpha 

two, APPLESOFT d 
■nancB C00D4L1TTLE 
ignored portion o 
specia], a quote 
"reserved wurds.' 
theae reserved uo 
thii) rule. } 



it}] 

CO 238 characters in length. 

ng. one name from, another, APPLESOFT 

numeric characters after the Elrat 

aes not distinguish becueen the 

and COLDRUSH. BoUever, evefl the 
f a name must not contain a 
(") or any of APPLESOFT'S 

(Sc« the Appendix A fot a list oE 
rds and comments on exceptions to 



lntvgar 



t-i: 



I+|-l(dl&U> 
Integers aust be in ttie range -32767 to 32767* 
MiPii converting noTi-lnCegers into integers , 
APPLESOFT may usually be considered to truncate 
the non-Integer to the next smaller Integer. 
However, this is not quite true In the limit as 
the non-integer approaches the next larger integ.er. 
E-'or instance: 



AI-123.999 999 959 999 

PRINT AZ 

123 

CI-1234S.999 995 999 

PRIST CI 

12345 



St«123.999 999 96 

PRINT AX 

124 

DI-12345.999 996 
PRINT DZ 
123'.6 



(Spaces added for easier reading) 

Alt array Integer occupies 2 bytea (16 bite) In pemory. 

InlWRur viirlnblc nacie 
1- n(im(.>Z 

A tv&l b^y be scared aa aa integer variable, but 
Aprt-KSOFT first converts the real to «ii integer- 



r»«l 



alphanumeric character 
:- lecterldlglt 



(- l+hHdigitK, (digit)] |£E+hldiglt|dIgltll 

I- i+|-|t<digie>l.Kdigii)llE|+|-]digit|diaitn 
The letter E, as used In real nutnber (location 
(a rorm of "scleficific notation"), 
■tnnda for "exponent." It Is shorthand 
Tor *10" Ten is raised to the power o£ the 
iiintnber on E's right, and the number on H'$ 
Icit Is multiplied by the result. 

In APPLESOE^, reals nniat be In the range -IE38 
to 1E3B or you risk the ?OV£RFLOW ERROR mcsaagc. 
Using ndd.i tion or subtract lon^ you may be able 
to generate numbers as large as 1.7E36 ullhout 
receiving this message. 



31 



30 



A teal vh{}£e absoluce value is less than about 
2.93BBE-39 will be convefted by APPLESOFT to z«ro. 

APPLESOFT recognlies the eollowing a» reals when 
presented by diemselve&t and evalyat^B chem as zero: 
+, -. *E +.E -,E 

,E+ -E- +,£- +.E+ -.E+ -.E- 

therefore. the array element H(.) Is the sane as H{|3> 

In addition to the abbreviated reals listed above, 
the following are recognized as reals and evaluated 
as zero when used as nuifierlic responses to INPUT or 
as nunerif elemi^nts of DATA: 



+ 


. 


E 


+E 


-E 


apace 


E+ 


E- 


+E+ 


+E- 


-E+ 


-E' 



Th* GET Instruction evaluates all of the slngle- 
ch^facter reals In the above lists as zeroi 

When printing a real nuniber, APPLESOFT will show 
at ciDBt nine digits (aee exception, bclowl. 
sKcludlng Che exponent (If any>. Any further 
digits are rounded off. To the left of tlie decimal 
point, any Zhvob preceding the IdfttdOSt tion-zero 
digit are n«t printed- To the right of the decimal 
point, any zeros following the rightmost non-Kefo 
digit are not printed. If ttiere are tid non-Kcro 
digits CO the right of the decimal point, the 
decimal point is not printed- 



9> 



Rounding can be cjriousi 

PaiNT 99 999 999.9 
99 999 999.9 

PRINT 99 999 999.99 
\W 9^9 00d 

PRINT 11,1 11 UL i>1>9 00 
11. Ill 1115 

PRIKT 11,111 111 -151 9 
lull! Ill A 

(Spaces added for easier reading) 

[f a real's absolute valu^ Is greater Chan or 
equal to .01 arid less than 999 999 999. 2» the 
real is printed in flxed-pplnt notation. 
That is, no exponent 1b displayed. In the raage 
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.0 100 000 000 3 to .0 999 999 999 
real:!! are printed with up to ten digits, including 
the zero IniBedl^cely co the right of the decimal 
point. This is the only exception to the limit of 
nine printed digit&t excluding the exponent- 

If you attempt to use a niiffibet ulcVi fflore than 38 

dlgi t», t^uch as 

311.1 Mint lllllllIllHinilt LIU IIULIL 

thi'n the* message 

TOVta^FLOW ERROR 

In printed, even if the nunber Is clearly within 

the rjiitge -1E3S through JE3&. This Is true even 

If most of the dlf^its are trailing zeroes, as in 

211. 00 1*000 000 000 00 00 00 0000 00 1^000000 00000 

Lend Ing BeroSj however, are ignored. If the flrsC 

digit is a one, and the second digit Ls less than 

or equal to slxi numbers with 39 digits may be 

used bl thout getting an error mesaage. 

A real occupies 5 bytes (40 bits) in memory^ 



tvn\ Vdirltible name 
i> naate 

«rlthnrtlc variable 
1- ituiir 



I " name jnameX 

All almplu variables occupy 7 bytes In raeinory, 2 bytes for 
[Iw name and 5 bytes for thi^ real or Integer value. 



dill Iml tor 



■|(l)l-l-l+l"]>l<l/!*l,l;|: 

A [innte does not Kaue to be separated froia a 
preredfng or following reserved word by any 
of these delimlterst 



HI I tlimi'i If ^iperator 
I" aiip 



anp 



k 



!- ti-i«i/r 



AftlhtqcLli^ logical opetatDC 
i^ alop 



a Inp 



!- AHD|OR|-|>|<|<>|><|i-i->|<-|-< 

HOT Is not included here an purpose. 



operator 
s- op 



:" nop la lop 
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arithmetic expre&SlOi) 
I" aexpT 



aexpr 



avar I real llnteger 
r- (aexpr) 

If pacenthesea are nested tnote than 36 levels deep, the 

?OUt OF MEMORY ERROR occurs, 
1- [+|-|HOT)aexpr 

Unary BOT appears here, eJLong »ith unary + and -. 
:- aexpr op aexpr 



subscript 



(aexpr K, aexpr)] ) 

The naximum number oE (Slmensions la 89, 
although In practice this will be limited by 
the extent: of Dkemory available^ a?xpc must be 
positive! and in use It is converted to an Integer^ 



:- avat substrlpc 

aexpr 

:- avar subscript 

literal 

-* [{character}] 

string 

:- "Kcbaractec)!" 

A string occupies 1 byte (B bits> for its length, 2 bytes for its 
location pointer, and J byte £or each character In the atring. 
'.9 "[{character)] cetiirn 

ThlB form of the string can appear only dt the end o£ a line. 

Dull it ring 
>_ «■■ 

ectlng variable name 
:' name$ 

string variable 
i - avar 



:- naae$|nane& subacrlpt 

The location pointer eorf variable name each occupy 2 bytea 

tn Tneraory. The length and each string character occupy one byte. 

string operator 
s- eop 

sop 



string expression 
:~ sexpr 
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r- c 



r 

r 

rt 
I- 






'!: 









■tcKpr 

;- uvarjatring 

: •• Hcxpr sup aexpr 

nl r I iiK t Oft deal operator 
: - Nlop 



n]ii]i 



.- .|>|>,|->|<|<-(-<|<>i>< 



ni-)i|ir 



:• floxpr sl&p oexpr 



variable 

1 ■ var 



; - iivnr | svar 



CKpruanLnn 

r- expr 



]- Acxprlsexpr 

lirnmiit character 
:- I 

The right bracket 0) la displayed when APPLESOFT 
is ready to accept another comnandt 



:- A prees of the key marked "RESE.T" 



;- n press of the key marked "ESC" 

I V t u r n 

-[ n press of the key marked "RETURN" 

rtrl 

:- hold down the key marked "CTEL" while the following 
named key is pressed. 

Ilm^ iiuisb£:r 

1- llnenun 

I Inanun 

:<• (digit) 

Line numbers must be in the trai^ge ^ CO 63999 
or a tSYNTAX QtROR roeBeage results. 



I Cne 



:- llnenum |< inatructlon : >] Instruction return 
A line may have up to 239 characters. This 
includes all spaces typed by the user, but 
does not include spaces added by APPLESOFT 
In formstting the line. 
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RULES FOR EVALUATING EXPRESSIONS 

Operacars are Hated vertically In order pf execuCloa, from the hlgliest 
priority (parentheses) to the loWeSC priority (OR). Operators listed on th« 
same line are of the same priority- Operatars of the sam€ priority in an 
fiKpression are executed from left to clghE. 



+ - NOT 



Linary operators 



+ - 

><?.<. -> -< <> >< > 

AND 
OR 

CONVERSION OF TYPES 

Ulien an integer and a real are both present in a calculation, all aumbers 
are converted to reals betore the calculation takes place. Tine reaults are 
converted to the atlthroetlc type {integer or real) oi the final variable to 
which th«y are asslgTied. Functions which are defined on a giver arlttiineclc 
type «ill cortverc arguments of another type to the type for which they are 
defined.^ Strings and arithmetic types cannot be mixed. Each can be 
converted to the other by functions provided for the purpose. 



EXECUTION MODES 

Imm Same InstrucCiooa tuy be used in Imnediate-execuCiDn mode 
(Inm) in APPLBSOFT. In imiaedlate-cjcecutlon mode, an 
instruction must be typed without a line number. When the 
RETURN key la pressed, the loBtcuctlon is immediately executed 



def Inatructlons used in deEerred-execulIon mode (deE) must 

appear In a line that begins with a line number. Uben the 
EETUBN key is pressed, APPLESOFT stores the numbered line 
for later uee- instructions in defcrred-eKecuclon mode 
are executed only when their line of a program Is RUN* 



I 
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r- 
I 



t 

t 

F 

fc. 



CHAPTE 

SYSTEM AND 
UTILITY COMMANDS 



1H 


U1A» «nd SAVE ^ 




)« 


HKW 




J» 


HUN 




it 


STOP, EMD. Ctrl C. 


reset end CONT 


4fl 


TRACE and HOTRACE 
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PRRK 




41 


PQKK 




41 


UAIT 




ki 


CAM. 




4) 


llinK>1: 
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lAIKKH : 




4S 


USR 






I 



tOAQ Imm & def 

SAVE 1mm & def 

LOAD 
SAVE 

These LOAD B progcam froB a caseecte tape and SAVE a program on s cassette 
tape, reapectlvely. There is no prompting meaeage or other SlRnal Issued by 
these comnands; Che user must have the cassette tape recorder running In the 
proper QiodE; (play or rei:ord!l uhen the command le esecuted. LOAE and SAVE da 
flOt verify that the recorder la In the propec mode or even that the recorded 
la present- Both eommands scund a "beep" to slgnaL the beginning and Che 
end of recordings- 

Program execution continues after a SAVE operation, but a LOAD deletes the 
curtent progCaa uheo Ic baglns reading new InEormaclon itom cHe eaaaette 
tape. 

Only reset can Intectupt a LQAD or a SAVE. 

If Che reserved word LOAD or SAVE la used as the first charactera of a 

variable naae, the reBcrved-word coranand may be executed be lore any 

ISYNTAX ERHOR message is given- The statement 

SAVER IKG - 5 

causes APPLESOFT to try SAVElng the current program. You cat* wait for the 

second "beep" {and Che TSYNTAX ERKOR message) or press reset. 

Hie statement 

LOAOIOJOY » 4 7 

hangs the BystEm, while APPLESOFT deletes the current program and waits 

indefinitely for tk program from the cassette recorder. Only by preaalrig 

reset can you regain control of the computer* 



NEU 1mm & del 

HEW 

Ho parameters* Deletes {lurrent progran and all variables. 

RUH imm 6 dct 
EtW [linenunl 

Clears all variables* polaterst and stacks and begins execution sC the line 
number indicated by llnenun. If llnenum Is not indicated, RUN begins at the 
louest nurabeted lloe in Che program, or reCurns control CO the user If there 
Ig. no progtan In memory. 

In deferred «xecuCj;oin eiode, If llnenum la given but there Ib no Such llive In 
Che program, or IE linenun Is negative^ Chen the message 
?UNDEF'D STATEMENT ERROR 



E- 


« 


F 


c 


F 


« 


[• 








:• 




T 
i 




I 












apfn-arn. [f linenum is greater than 63999, the message 

7SVNTAX t:«HOR 

niipnara. You are not told in vhich line the error occurred. 

In ImmcdlFiLc cKecuClOn mode, on Che other band, these two measages become 

TlINm:K'l> aTATEHENT ERROR IN xnx* 

ntid 

rnVNTAK VMROn IN xxxx 

whotx' Hxxx can be various line numbers, usually above fiS000. 

II HUN is. used in an Immedlate-execu'clan program, any BubsequenC portion o£ 
I hi< Jmm<>r1lnte-execution program is not execucedv 



M'lr Imm b del 
KHD Inm h iWI 

rl rl C imm iinly 
r*B»l 'Imn nnly 
f'niVT tnm b del 

Mor 
hNl) 

• irl C 
I ■•■at 
euiNT 

KTliI' I jiiiti{>H a program to cease exe^^ucion, and returns control of the 

I ■.■niHitvr to the user* 1c prints the inessage 

HHKAJC Itt llnenum 

whtirv I Incnum 1b the line number of Che statement which executed the STO?* 

I'.HIl rnuHi'H a program to cease execution, and returns control to the user. 
Ho nwHuflgti is printed. 

iirl C hfta an effect equivalent to the insertion of a STOP statement 
JniiH<dl{iii>Iy after the statement that la currently being executed. Ctrl C 

I nn hi' lined to interrupt a LlSTlngi It r^an also be used co incerrupt an 
IHI'IIT, bill only if it Is the first character entered. The IKPUT is not 
liiii'r rmptcd until return is pressed* 

iKiii'i utitps any APPLESOFT program or command unconditionally and 
ImiH'dLiK-ly. The progratn la mat loaCr but sotue program pointers and stacks 
Mrr flvntedt This command leaves you in the sysceis monitor program, as 
lndUdii4d by the monitor's prompt cbaraccer ( * )• To reCurn co APPLESOFT 
without destroying Che current stored progrsm^ type Ctrl C reCurn- 

II program execdtion ha& been halted by STOP, ENB or Ctrl C, che COHT 

cannuirid causes execution to resume at the next instruction — not the 
nM^Ht Hill- number. Kochlng Is cleared. IE chere is no halced program, then 
CUNT hnH no effect- Afcec reset ccrl C return the program may not CONTlnue 
to execute properly, since some program pointers and stacks vill have been 
r I eared. 
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If an INPUT scatentent is halted 1)V Ctrl C, an attempt to CONTlnue execution 

reauLts in a 

?s™TAX error in UnenuEn 

message^ nAere linenum ia the line nuobet of Che line conUlning tha IHPIJI 

Bta cement. 

Executing CDHT uill result in Che 

?CAN'T CONTINUE ERROR 

oiessage If, after the program's BxetuClon halts, the user 

a> modifies or deletes any prograffl line. 

b) attempts any operation that results in an error message. 

Hovever, prograa varialiles can be changed usirg Icmiediate-execuclon 

comoarda, as Icng as OS error cneBsages ace incurred- 

II PEL iG uEed, in a deferred eKecuElon statement, the specified lines are 
deleted and then prggram ejcecution hdlts^ An attempt to use CONT under 
chese ctrr^umsLanceS will fdyse the 
TCAH'T CPJiTlNUE ERROR 
nessage* 

If COKT is uBed In * deferred execution statement, the prograin'9 execucion 
la halted at that &tatettient, but control of the computer la not rcturfled 
to the user. The user can regain control of the computer by Issuing a Ctrl 
C command, but an attempt to CONTinue program execution in the next 
statement merely relinquishes control to the halted pcogram again. 



TRACE Imn & deC 
NOTHACK Imm b dcf 

TRACE 
HOTRACE 

TRACE sets a debug mode that dlspliPya the line number of each statement as 
it i3 executed. When the program also prints on the screen TRACEs may be 
(Jl&played In an unexpected fashion or overwritten, KOTRACE tucna off the 
TKACE debug inode. 

Once set, TRACE is not turned off by RUN, CLEAR, KEH, DEL or reaec; reset 
Ctrl B turns off TRACE (and eliminates any stored program). 



I'EKK loiin i. di:£ 

PEEK (aexpT) 

Returns the contents, in decimal , of the byte at addreaa \aexpr\. 
Appendix J contains cxsnplea of hou CO use PEEK. 



J^ 


s 


fF 


« 


1^. 


^dS 


r 


c 


f; 


£ 


r- 


C 


p 


r 


r 


f 



fr C 

V C 

( £ 

i' C 
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tic 



POKE Imm t. det 
POKE aexprl, aexpfZ 

POKE atoTca an eight bit quantity, the hlnary equivalent of Che declmsl 
valu« \«iiKpr2\, Into the location whose address Is given by Vaexprl^. The 
riAng« of Vae}(pr2\ must be from 9 through 255; chat of \aexprl\ nust be from 
-4553) through 633J5* Reals are converted to Integers before execution. 
Out of range values cause the message 
?n.l.E<;Al. t)ilANTlT¥ EHROR 
to b« printed* 

\«axpr2\ ulll be auccesHfully stored only If the appropriate receiving 
hflrdwuri!' (memory, or a suitable output dcvlccl^ la present at the address 
HpvcKled by \aexprl\. VaeKpr2\ will not be successfully stored at 
iiun-recepLivc addresses such as the Monitor ROMs or unused Input/Output 
p(> t C H , 

III Bifncrnl. this means, that Vai>yprl\ will be in the range throoRh max, 
whiLTt- laaa Eb determined by the ataouiit of iMinory in Che computet, for 
liiHtancc, on an APPLE 11 uich 16£ of memsry, max is 16364. If the APPLE 11 
ItiiN I^K of meniory» max is 32766; and if Che APPLE 11 has 43K of memory, max 

Hiuiy envBiory locaCiOnB contain information which is necessary to the 

I UEirt Inn Ing of computer system. A POKE into these Ideations raey alter thie 

ii|iiir«t(an of the system oc of your program* or it may clobber APPLESofT. 



UAIT Inn & dof 



MAIT iiuxprl, aexpr2 [, aexprJJ 

A] Imwij UBC-r no insert a conditional 
liitn-rrnpl ti WAIT- 



ause Into a program* Only reset can 



VaoMprlX 1b the address of a memory Location; It must be in the range -65535 

ttirough 65535 to avoid the 

.•n.l.f.i:AI. QUAHTITV EUROS 

mi'HMiigi-. In practice, \aeiiprl\ Is usually limited to the range of addresses 

correnpondlng to locations at which valid memory devices exist, from 

tUruugh the maximiD value for HltlEM: in your cocipiiter . See IIIM04: and POKE 

l»r nace details. Equivalent positive and negative addresses may be used. 

\^M'Mpr2\ and \acxpr3\ must be in the range through 25^, declmal> l^en 
WAIT iH exei-uced, tKese valnea -are converted to binary nufnbera in the range 
tf ihroiigh 111) L1H< 

li unly auxprl and aexprZ arc specified, each of the eight bits in the 
liJii.'iry contents of location XaexprlX is AHDed wi th the correBpondlng bi t in 
th« binary equivalent of \acxpr2\< For each bit, this gives a zero unless 
hiiili i>f the corresponding tii^B are high (1). If the results of this process 



41 



are eighc zeias, then the test Is repeated. If any result la non-sero 

{uhlch meaTis at leest aae high (1) bit in \aexpr2\ uas unatched by 6 

correapondlRg high (1) bit at location \aexprl\), the WAIT is completed .ind 

Che APPLESOFT pmgram resumes execution at the neKt Insttuttlon. 

WAIT aexprl. 7 

causes Cht frrogram to pause until at least one o£ the Ciiree rightmost blt» 

at location \aeiipr]\ is high (1). 

WAIT aexprl, 9 

causes tbe progiara to pause forever. 

If all three patan)eE«rs ere specified, then WAIT perEorma ae follous: fir^ti 
each bit In the binary contents o£ location \aexprl\ 1b XOKed with the 
correspoTidiTig bit in the binary equivalent of \aexpr3\. A high (1) bit in 
\aexpT3\ gives a result Chat is tine reverse of the corresponding bit at 
location \ae3cpcl\ <a I becomes A 9; a i becomes a 1). A low Cfl) bit In 
\aexpr3\ gives a result that is the same as the corresponding bit at 
location VaexprlV. IE \aexprJ\ Is }vet xero, the XOR portion doea nothing' 

Secondt each result is AKDed with the corresponding bit in Lhe binary 
equivalent of \aexpt2\. If the final results are eight zeros, the teat la 
repeated. If any result is non-zero, the WAIT Is corapleted and execution of 
the APPLESOFT program continues at the next Instruction. 

Another way to look at UAIT: the object is to te»t the contents of Location 
\aexprl\ to see uhcn any one of certain bits is high (1, or on) or any 
one of ccrtflln other bits ia lev C^t or off). Each of the eight bitH In 
the binary equivalent of \aexpr2\ indicates whether you are Interested in 
Che corresponding bit at location \aeKprl\: 1 means you're interested, 
means ignore that bit- Each of the eight bits 1(1 the binary equivalent of 
\aexprJ\ indicates uhieh state you are WAlTing for the corresponding bit In 
location \aexprl\ to be in: 1 ineana the bit hjubC be low, seto raeacis the bit 
must be high. If any of the bits In which you have Indicated interest (by 
a 1 In the corresponding bit of \acf(pt20 matches the state you specified 
fpr that hit (by the corresponding bit of \aei(pir3\> the WAIT is over. If 
acxprl i-3 omitted,, its default value is zero. 

For Instance: 

WAIT aexprl, 255, nteans pause until at least one of C'he 

5 bits at location NaexprlX is hl^h. 

WAIT aexprl, 255 identical Co the above, in operation. 

WAIT aexprL, 255, 255 nteana pause until at least one of the 

6 bits at location VaexpflV Is ]sw. 

WAIT aexprl, 1, I means pause until the riglitmoat b£t 

at location \aexprl\ )3 lo", regardless 
of the states of the Other httiB, 



f- C 

t' m 

r- c 

t: C 




UAIT aexprl, 3* 2 



means pause until either the rightmost 
bit at location \aexprt\ la high, or 
the next-to-rightraost bit is low* or 
both conditions exist. 



Tills program pauses until you type any character whose ASCII code (see 
Appendix K> ia even : 

100 PiJKi; -16368, 9 : REM RESET KEYBOARD STROBE (HIGH BIT) 

Itf-f REM PAUSE IfflTlL KEYBOARD STROBE IS SET BY ANY KEY. 

ItV WAIT -16384, 12B : RB\ UAIT UKTIL HIGH BIT IS OHE. 

W'l KEH PAUSE SCWE MORE UHTIL KEY STRUCK IS EVER. 

1^1^ WAIT -16384. I, I I REM WAIT UNTIL LOU BIT IS ZERO, 

lilt PRIWT "EVEH" 

Htfi GOTO 1011 



CALL Imm & def 
CALL acxpr 

CfflUBCB execution of a machlne-laoguage subroutine at the memory location 
wlntiae Jectmal address Is specified Ity \6biipz\- 

\nenpr\ TOiSt be in the range -55535 through 65535 or the message 
71LLEGAL QUANTITY ERROR 

Ip displayed. In practice^ \Hexpr\ is usually limited to the range of 
addresses for which valid memory devices exist, frara through the maxlmuni 
vnluG for HIHEH: in your contputer. See HIMEM: and POKE for more details. 

F.c|iilvalent positive and negative addresses o»y be used interchangeably. For 
IflBtance, "CALL -936" anci "CALL 6460?" are identical* 

AppendiK J contains examples of the use of CALL. 



H!;il,M; inn i def 

i\\MV»: aexpr 

Sets the address of the highest raemory location available to a BASIC 
pfogfam, including variables- It is used to protect the area of memory above 
lE for data, graphics or machine language routines* 

VaexprV must be In the range -65535 through 65535, Inclusive, to avoid the 
71UECAL QUAKTITY ERROR 

message. Hosiever, programs may not execute reliably unless there ia 
appropriate oenory hardware at the locations specified by all addreBsea up 
to and including ^aexpr\. 

In general, the maxlnniffl value of aexpr is determined by the amount of memory 
In the computer. For Instance, on an APPLE 11 with I6K of memory \aexprV 
would be ]63B't or Less. If the AFPLC II has 32K of nemory, \aexpr\ could be 
as high as 32768; and If the APPLE II has ■ifiK of memory, \aeKpr\ could be as 
high as 49152. 

Normally, APPLESOFT aucomaCicslly sets UlHEM: to the highest memory address 
available on ibc user's computer, when APPLESOFT is first Invoked. 
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The cyrrent value of HIMEM: Is stored in memory locations U6 and U5 
(decimal). To see Che current value of HlHEMi^ type 
PBIHT PEEK(116)*356 + PEEKillS) 

If HIHEH: sets a highest memory address which is lower ch^n chat set by 

LOHEMit or which doea not leave enough menory available for the pEORraro to 

runt the 

?OUT OF MEMORY ERROR 

i& given. 

\aexpt\ may be in Che range increasing CO fr5535, or in the equivalent 
range -65535 increasing to -1. Equivalent poslclve and negative values may 
be used interchangeably. 

ttlHEM: Is not reset by CLEAR, RUH . NEW, DEL, changlTig or adtSlog a program 
line, or reset. HIHEH: is reset by reset ccrl fl return, which also erases 
any stored program. 



UIHEM: Iran & def 
LOHEH: aenpr 

Sets the eddress of the lowcGt memory location available to a BASIC program. 
This is usually the address of the atarclng Taemory location for the first 
BASIC variable. Hormally, APPIESOFI aucomatlcally sets LOHEM: to the end of 
Che current program, before executing the proe""!. This c<3miuand allowB 
protection of variables from high-reSolutlon graphics In computers with 
large amounts of nenory. 

\aexpr\ must be In the range -65535 thTOugh 65535. inclusive, to avoid the 

IILLEGAL QUANTITY EBBOS , ^ ^,„„ 

message. However, IE LOHEH: is set higher Chan the current value of H1MEM-, 

the cneseage 

70UT OF MBIORV ERROR 

Is displayed. This means chat \aexpr\ must he lower tttm the maximun 

value thac can be set by HIMEM: (See HIHEH i for a dlscitasion of it* teflxiiniim 

value. ) 

If LOHEM: Is sec lower than the address of Che highc&C memory location 

occupied by Che current operating syBtem (plus any current stored program), 

the 

70UT OF MEHORV EBHOB 

oeasage is again displayed. This Imposes an absolute lower Itmtc on \3expr\ 

of about 2fl51 for firmware APPLESOFT. 




LWIEH: is reset by NEW, 0EU and by adding or changing a program line. 
LOHEH! is reset by reset cCrl B, which also deletes any stored program, 
ie not reset by RUN, ceaec ctrl C return or reset fIG return. 

The current value of LOMEMi 13 stored in memory locations lp6 and ills 
(decimal). To see the current value of LOMEM:, type 
PRIHT PEEK(1(I6)*Z56 + PEEK<195) 
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Once aet, unless it is first reset by one of the above commandB, LOKEH; can 

be act to a new value only If the new value Is hishef (in metaoty} than the 

old valuer An attempC to Set a lower lOHEM: th^n the value still In effect 

KCves the 

1n\n flF MEMORY ERROR 

message. 

Changing LOHEH; during the course o£ a program may cause certain stacks or 
portions of the program to be tinevailable, so that the program will not 
continue CO execute pcoperly. 

Equivalent positive and ni^gaClve addresses may be used interctiangeabiyi 



nsK innr b def 

USR (aexpr) 

Thin function passes \3expr\ to a machine -language subrouEine< 

The argument aexpr is evaluated and put into Che floating point accumulator 
(locations 39D through SA3), and a JSR to location 5«)A Is performed. 
Lucatione. $0A through Si?C must contain a JHP to the beginning location of 
the? mat^hine-language aubroutlne. The return value for the function Is 
placed in the floating point accumulator. 

To obtain a 2-byte integer from the value in the floating-point accumulator, 
yowr subroutine should do a JSR to $EI^. Upon return, the Integer value 
wlH be in locations $A0 (hlgh^order byte) and $'A1 {low-order byte). 

To convert an integer result to its floating-point equivalent, so that the 
function can return that value, place the two-byte Integer in registers A 
(high-order bytc)^ and V (low-order byte). Then do a JSR to SE2F2, Upon 
return, the f loactng-polnt value will be in the floating-point accufflulacor. 



USR function, Just Co show you the 



To roCurn to APPLESOFT, do an RTS. 

Here i& a trivial program using Che 
format : 
1 reset 

* ^A:4C 99 03 return 

* ^fi^^-fi^ return 

* Ctrl c retuto 

] PRINT USR(8)*3 
24 

At l^ocaCion SlIA, we put a JHP <code 4C) to location S30|l (low-order byte 
rifHtf then high-order byte). At location S3fl0, we put an RTS (code bP). 
Bacic la APPLESOFT, when ISR(8) was encountered the argument & was placed in 
the accumulator, the Honltor did a J5B to location StfA where It found a JHP 
to SiflB. In S3flfll It found an HTS which aent It back to APPLESOFT. The 
value returned was Just Che original value 8 in the accumulator, which 
APPLESOFT then multiplied by 3 to get 2A. 
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P EDITING 

AND FORMAT-RELATED 

COMMANDS 



[n Chapter Ji alta »se Ctrl Ci 

iH LIST 

A 4 DEL 

» REM 

^fl VTAB 

i9 MTAB 

51 TAB 

51 POS 

52 SPC 

52 Hone 

57 CLEAR 

53 HIE 

53 FLASH, IHVEKSE and NORMAL 
W SPEEO 

54 cue A, ecc B. e&c C and esc D 
5i repeat 

55 right arrov and loft arrou 
ii Ctrl X 
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LIST inra (. ^ef 

List [llnenualj [- litienunZ] 
LIST [linenutnl] [, litienumZ] 

If neither llnenunl oar linetiumZ la present, wicV. or without a dellloUflr. 
the entire program 1b displayed on the scteefi. I* lifienyml Is prcaerit 
without a delimiter, or if llnenuTnl-Uneniim2. then iySC the line nufflberj.d 
linenunl Is displayed. H llnentiml SKd a delimiter are present, then the. 
nrooraBi Is Hated from the line nuinfaeted llnetiuml through the end* H -i 
Seli^Uer and linen.m2 are present, ther. the program U IJ^'f *""; J ;^' ^„,^ 
beginning through the line numbered lioenymZ. If llnen.iml. a dellmUrr nnd 
llqenun.2 are all preS^-it, then the program Ib listed from the line nimb.^rcd 
llnenuffll through the line numbered llnertum2, Inclusive. 

When more than one line is to be listed. If the line numbered linenuml Irt 
the LIST statemeRt doM not appear in the program, the I.1ST command wU i.« 
the next greater line nuinber that does appear in the program- IE the hup 
numbered linenumZ in Che LIST gtateinent d&es not appear in the program, the 
LIST conmand will use the next smaller line number that does appear In the 
program. 

These all UST the entire program: 

LIST LIST [,|-1 t LIST e 1,1-J 

lists Erorthe line uith Line number llnenuft through ttie end of the program. 

LIST , q 

lists the entire prosram, then gives the 

? SYNTAX ERBOB 

message. 

APPLESOFT "cokenlzes" your program Ufiea before fltoring them, removing 
unnecessary spaces in the proceas. When USTlng, APPLESOFT reconstitutes 
the toltenised program lines, adding spaces according to its own rules, hor 

example, 

1» C-+5/-6;B— 5 

becotses 

10 C * + 5 / - 6;B ■ - 5 

vhen LtSTed. 

LIST uses a variable Une width and various Indentations- This can bt a 

probleis when you are trylna to edit ot copy a LlSTed inat fi.ctlon. To force 

LIST to abandon formatcins with extra spaces, clear the screen and reduce 

the text window to uldch 33 (maKlrouw): 

HOME 

POKE 13,33 
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APPLESOFT truncates a Hue to 239 characters, Ihen LIST adds spaces 
liberally. So you can enter many extra characters by leaving out spaces 
when cvplaa — LIST adds them back. An attempt to copy your e?tpanded 
statement ftom the screen results in truncation to 239 chdracters again. 
Including the spaces added by LIST. 
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DEL Imn & def 

DEL llnenuml t linenu92 

DEL deletes the range of lines from linenunil to linenum2, inclusive. If 
HnenumL Is not an eKistlng program line number, the next greater line 
number In the program Is used in lieu of llnenuml; if llnenu[ii2 is not an 
PxEstlng program line number, the next smaller program line number is used. 

H you don't f ol low the usual f onnat , DE-L's performance varies as Indicated 
bi'loui 



DVDtax 




ECSUll 
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PF-U 




75YNTAX 


ERROR 


DEL , 




? SYNTAX 


ERROR 


DEL ,b 




7SYMTAX 


ERROR 


DEL -a I, 


.b] 


?SyNTAX 


ERROR 
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DEL 0,b deletes line zero, regardless of the vdlue 
of b. 

DEL 1,-b ignored, even II the program's smallest line 
number £s aero. 

DEL a,-b ^SYNTAX ERROR if a is greater than the 

program's smallest line number , unless the 

program's smallest line Dumber Is seto and 
a is one> 

DEL a,-b ignored If a is not zero and the only 
program line Is line number zero. 

&KL {i,-b ignored if a Is not zero and if a Is leas 
Chan or equal Co the program's smallest 
line number. 

t)EL a[,] ignored. 



lO, DEL a,b ignored If a is not zero and a is greater 
than b.. 

Wli(.-n used in deferred execution, DEL works eg described above, Chen halts 
I'Ki-i'urlon. COKT will not work in ttila situation* 



tlSTing is aborted by Ctrl C- 
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B.Et1 itan & Act 

Rm {character I "> 

This serves Co allow tex^ of any sore co be itiBefted tn a program. All 
characters, including statenenC fieparacora and blanks may be Included. 
Their usual meanings are ignored. A REM iS terminated only by return. 

When BEHS are listed. APPLESOFT InSctts an extra apace after REM, no ttrnttct 
how nany Spaces were cyped after REM by the user. 



VTAfl Iram i. def 
vTaB aexpr 

Moves the cursor to ttie line that Is \flexpr\ lines down on the acrten- The 
top line Is line U the bottom line ia line 24. This stateaetit may Involve 
Bmvinfc the cursor either up or down, but never to ctie right or left. 
Arftumencs oacslde the range 1 to 24 cause Che mesBaae 
JILLECAL QUANTITY ERROR 
to appear. 

VTAB uses abfliluCe eoveb, relative only to the top and bottom of the 
screen : it ignores the te»t window. In graphics mode. VIAE will move the 
cursor into Che graphics area of the screen. If VTAB ^oves the cursor to a 
line helow the text vindow. all aubsequent printing takes place on that 
line. 



HTAB iram h det 

VSTAR aexpr 

Assume the line In which the cursor is located has 255 poaitlons, 1 through 
255- Regardless of the text window width you may have set, poaltlons 1 
through 1*9 are on the current line, positions 41 through S9 are on the n«Kt 
line down, and so on. HTAB moves the cursor to the position that ia \aexptV 
positions Eron the left edge of the current screen line. HTAB's moves are 
relative to the left margin of the text window, but independent of the line 
widCh.^ HTAB can move the curBot oucslde the text window, but only long 
enough to PRINT one character. To place the cuceer in the leftmo&C position 
of the current line* use HTAB 1. 

HIAB moves the cursor to position 25it. 

If XaexprV Is negative oc greater than. 255, the mesBoge 
'ILLEGAL qUANTlTf ERROR 
is printed. 
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Ni.tL- that the strucEnree of HTAB and VtAB are not parallel, tn that SITABs 

bi'yond the right edge of the screen do not cau&e the 

?n.l.Ei:AL QUAHTlTf ERROR 

mi'uJiiiite, but cause the cursor to jump to Che next lower line and tab 

(<acxpr-l)HOD 6fl)+l- 



TAH Inm h dot 

TAB (acxpr) 

i'AB must he used in a PRINT statementt and aexpr must be enclosed in 
pnrL'nthi^ses. TAR moves the cursor to the poSltlan that Is \aexfir\ printing 
ponitjuns from the left margin of the text window If ^aexprV is greater than 
thi- value of the current cursor position relative to the left margin. If 
SiiexprX ts less than the value of the current cursor position, then the 
I'lirHur is not moved — TAB never moves the curaor to the left (use HTA£ for 
Lhls>. 

If TAR DioveG the cursor beyond the rightmost limit of the text window, Che 
curnor l» moved to the leftmost limit of the next lower line in the text 
window, and spacing continues from there« 

TAR<II} puts the cursor into position 25b. 

\nt''Hpr\ must be in the range through 255'^ or the meesage 
?1I.I.K:AL (QUANTITY ERROR 
III presented. 

TAB is parsed as a reserved word only If the next non-space character is a 
littft parenthesis. 



IX>S ImiR & def 

POS <isj(pr) 

HflurnA the current horizontal position of the cursor on the screen, 
relative to the left hand margin of the text window. At the left aiJirgtn, 9 
t n returned. Although expr is Just there to hold the parentheses apart , It 
Ik rvuluated anyway, so it Tnust not be Illegal. Anything uhlch can he 
Interpreted as a number, a string or a variable name may be used (at expr. 
tl expr ia a set of characters uhlch cannot be a variable name, the 
( hnracters fpust he enclosed in quotation raarlis. 

Note that for MTaE and tab posltlona are numbered from I, but for pas and 

fifK they're nmnhercd from fl- Therefore 

HKlNT TAB(23>: P05(?) 

rauavR 22 to be printed* ti^ile 

I'HIHT SPi:(231; POSfSJ 

catjueu 2!l to be printed* 
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SPC Imm i. def 
SPC (aexpr) 

Hiiat be used In » PRINT statement, ami aexpr must be enclosed In 
parenCtieaea. Introduces VaexprV spaces between the itera previously printed 
(or by default, the left margiti of the text window) > and the next Item to 
be printed. If the SPC co[aiM5.d concatenates! «ith the items preceedlng and 
following, by juxtaposition or by intervening eeml-colons. SPCtfl) doee not 
Introduce any apace. 

\aexpr\ must be la Che range 9 to 2S5, Inclualve, or the message 

? ILLEGAL QUANTITV ERROR i. * ,!,« *n™ 

appears. Howevec. on« SPC(aexpr) cen be concatenated to another In tlie form 

PRINT SPCC251l)SPC(li9>SPC(25&) 

sod BO on, to provide arbitrarily lacge poaittve spaces. 

Note that while bJTAB mowes the cursor to an absolute screen position 
relative to the left margin of the t^xt window, SPC(aexpt3 moves Che cursor 
a givCTi number of spaces away from the prevlonaly printed Item, this new 
poBltl^n may be anywhere in the text window, depending on th« location of 
the previously printed item. 

Spacing beyond the rlehtmosc limit of the text window causes spacing or 
printing Co resume at the left edge of the next lower line In the text 
window. 

When printing in tab fields, spacing my be within a tab field or across 
inco another tab field, or it nwy occupy a tab field of Ita own. 

If \aeKpr\ Is a real. It la converted to an integer. 

SPC is parsed as a reserved word only If the next non-spflce character is » 
left parenthesis* 
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VHE Itikd (■ def 

PVr. fcxpr) 

FRK rcturna the amount of memory (In bytes) still available to the user- 
Vim way sometiioes wind up with more memory Chan you expected, since 
APPLESOFT stores duplicate strings only once. That la, if AS-"PIPPIH" and 
H5-"1'1PPIN" then the string "PIPPIN" will be stored only once. 

II Che number of free nemocy bytes exceeds 32767, FRE(eKprl returns a 
ni-mative number. Adding 65336 to this number gives you the actual number of 
free bytes of oeiDory. 

FRECCKpr) returns the nutuber of bytes remaining belou the string storage 
iLIMii'G and above Che numeric array and string pointer array space (see memory 
map In Appendix 1). HIHEM: can be set as high as 6S333, buc If ic Is set 
bt-yond the highest RAM memory location in your APPLE, EHE may return a 
rnther meaningless otiwlief exceeding the memory capacity of Che computer* 
iHee KIMEH: and POKE tot a dlBcuBsion of Toemory limltg.) 

Wlien the contents of a Htrifig are changed during the course of a program. 
(f.R. AS which eqiualed "cat" becomes A$-"dog" ) APfLESOFT dqi?s not ellTnlnate 
"cat", but JiiBC opens new file for "dog". As a resulc, a lot of old 
ilMfjicters slowly fill down from HIHEM: to the top of the array space. 
API'IKSOFT will autoiiiaCicatly "housc-clean" when this old daca runs InCQ Che 
\rvi! array space, but if you are using any of the free space for laachlne 
Language programs or high-resolution page buffers, they may be clobbered. 
4lHlng a BCatement of the form 
X . FRE(fl) 

periodically wichln your program will force the houne-cleaning to occur and 
prevent Buch events- 

Although expr is just used to hold Che parentheses apart, it fa evaluated, 
■o It should not be something illegal. 



HDHE Iran 4 def 
HOHE 

Ho paraMtere. Moves cursor to upper left acreen position within the 
scrolling window and cUars all text within the window. Thia command is 
identical to "CALL -93b" and to "eec § return". 



CLEAR 

Ho parameters. Zer^ea all varlablee. arrays and strings- Resets pointers 
and stacks. 
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PLASM lum & def 
IMVEKSF. ima 6 d>ii 
NMRMAI. limn 6 def 

FLASH 

INVERSE 

NORMAL 

These three commands are used to set video Output modes. They do not use 
piirj^meter?. and they do not affect the display of characters as you type 
them I nto the computer nor characcera already on the screen. » 

FMSH seta the video laodc to "ftashliig", so the output from the computer 
is alternately shown on the screen in white on black, and then reversed to 
block on white. 

INVERSE sefs the video mode So that the computer's output prlnte as black 
letters on a white background. 

KUKHAL sets the node to the usual white letters on a black background, for 
both Input and output- 
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SPEED Inm i dci 
SPEED - dexpr 

Sets speed at whlcli characters are to te sent to Che screen oSf other 
input/output devices. The slowest Speed Is 8; Che fastest speed is 255. 
Out of range vaiues will cause the message 
TILLEGAL qUAhTlTV ERROR 
to be displayed. 



esc A imra only 

eBc B tmiB only 

esc C Iran only 

eac JmiB only 



(nit tln^ uiily) 
(editlni; only) 
(editing only) 
<t'dl tInR tinly 1 



the escape key* labeled "ESC", may be used In conjunction wiCh Che letter 
keys A ^f B or C or D to moue the oursor: to move che curSDC one space. 
f Irat press the e&cape key, then release Che escape key and press the 
appropriate letter key. 



commafid 


moves cursor one 
snace to ttie 


esc A 

eac B 
esc C 

GBC D 


right 

left 

down 

yp 



These escape conitaands do not affect the characEera soved over by the curaorJ 
the characters remain both on the TV screen and in memory. By chemselveB, 
the escape commands alao do not aEfecC the program line being typed. 

To change a program line, LIST Che line on the screen and use the escape 
conmaads to move the cursor so that It site directly mn the vpry first 
characCer ol the LlSTed line. Then use the right-arrow and REPT keys Co 
recopy the characters from the screen, typing a differenc character whenever 
the cursor is on a character you ulsh Co change. If you dtd not LIST the 
line, do not copy Che prompt character (11 that appears ac the beglontng of 
the line. Finally, press the RETUBH key to score che line or enecute 
It. 
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The repeat key 1b the key labeled "BEFT'V I* you hold down Che repeat key 
while pressing a character key, the character will be repeated. The first 
(Ine you prcsa the tepeat key alone. It "tejieats" the character last typed* 



right arrow imm oaly 
li'*f nrw'tw Inia finly 



(editing only) 
f<?di t inr r>nlv } 



Tlic right-arrow key moves che cursor to the rights As che cursor moves, 

fach character it crosses on the screen la copied into 

APPLK~Tl'a memory , just as if you had typed the character- It Is 

u»i,'d. with che repeat key, to save retyping an entire line when ofily minor 

i-liiiiin|iie& are required. 

Till' left-arrow key moves the cursor CO Che left. £ach time Che cursor moves 

to the left, one character Is eraaed from the program line 

which you are currently CvplnR . regardless of what the cursor Is 

m(Wlng over- The screen is ignored by this command, and nochlng Is changed 

an the screen. 

UiitesB you are currencly typing a line Cor which recurn has not yet been 
jiressed, the left-arrow key has no current pcograEn-l Ine characters to erase* 

In this case, Its use will cause the prompt character CI) to appear In 
t-nlumn of the next lower line, followed by the cursor. That is why Cha 
cursnr frenuently cannot be moved to column of the TV screen by using the 
Iffl-arrow key: a current program-line character must be erased for each 
mwc. For pure noveB, without *r«al«ig or copyiog, see the escape cornmands. 



crl X iKiu only 

Tells the APPLE 11 co Ignore the line currently being typed » without 
deleting any previous line of che same line number. A backslash (\> is 
displayed at the end of the Ufie to be ignored, and the cursor jumps to 
column of the following line. This cOminaod cafi also be uaed during a 
renponse Co an INPUT Instruction* 
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ARRAYS AND STRINGS 



5fi DIH 

}9 LEN 

S9 SIRS 

59 VAL 

60 CHR$ 
60 ASC 

60 LEFTS 
fri Rictus 

61 HIDS 

hi STOSE and BECALL 



DIM Imm & dcf 

DIM var subscript L<,var subscript)] 

When a DtH scaCcment is executed, ic aeCa aside space for the array with the 
name var. Two bytes in fflemory are used for storing an artay variable name, 
t«o for the size of the array. One for the number of dimensions, and two for 
each dimeneion. As dietuSBed below, tbe amount of space allocated for the 
elements of an array depends upon the type of array. 

StibacrlptB range from fl to \subscrlpt\* The number of eleaencs in an 
niliniensional array Is 
(\sufciserlptl\+l)*(\siibBcript2\+l)*,. ,*{\aubSgtiptii\+L) . 

E.g. DIM SHOW <A,5,3) sets aside 5*6*4 elements (128 elements). Typical 
eleoentG are: 

SHOW (A. 4.1) 

SHOW (fl.0.2) 
and so on. 

The Tnaxlmvn nwrntier ol dlmensiOTis for an array Is 88, even if each dimetislon 
can contain oflly one elenent: 

DIM A(4',0, 9) lAere there are 89 zeros gives an 

?OUT OF HEMOR* error 

but DIM ACd.fl,...*!) where there are B8 zeros does not. 

In practice, however, the size of arrays is often limited mucin more by the 
amount of netaory available. Each Integer array element occupies 2 bytes (16 
bits) lo memory. Each real array clecieTit occupies 5 bytes (^ill bits) In 
aemory. String array variables use 3 bytes for each element (one for 
length, two for a location pointer), storeil as an integer army when the 
array la alllenaioned. Aa the strings Chemselvea are gtored by the program, 
they occupy an addltlooal one byte per character- See pa$e 137 for taap. 

It an array element is used Irt 9 program before that variable Is 
DIHensloned, APPLESOFT aseigns a maximum subscript of 1(1 for each dlraenelon 
in the cleiaent's subscript. 

Using a variable whose subscript Is larger than the maximum designated, or 
which calls for a different pmnbcr of dinenslons than specified In a DIM 
statement, causes the 
?BAD SUBSCRIPT ERROR 
message to appear* 

IE the program DIHenslons an array that has the same name aa a previously 
DIMensioned array ievcn If DlHenSioned by default usage), then the message 
?REDIH*D ARRAY ERROR 
appears. 

The individual strings In a string array are not dimenaloned, but grow and 

shrink a& necessary. The statement 

WARDS<5) - "ABCDE" 

creates a string of length S. The statement 

WARDS(5) - "" 

de-alLocates the space allotted to the string VAHD$(3). A string nay 

contain a naxlmum of 253 etiaracters. 

Aeray elenents are set to zero when HUH or CUEAR are executed. 
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l.KN Inm & cIl-T 

LEN (Rcxpr) 

This fuACtlon returns the numbet of characters In a string, between 9 and 
i't'i. If the argument Is a concatenation of strings uhose gotqbtneil length la 
Kri'ji(.i>r than Z5i^, the message 
r STRING TOO LONG ERSOR 
In givun. 



TR} iara & dcf 

STRS <o«iipr) 

Tliln. function converta \aexpr\ Into a string which repreaenta that value. 

.ii-xpr Ib evaluated before it Is converted to a string. STRS<i(fO Sf^f! 000 

M9t t)--turn9 1£+11. 

n \/ii.>xp'F\ eKceeda the llmlcs for reals, chen the aesasge 

tuVVMYWU R31R0R 

L» displayed. 



VAI 1mm b del 

VAI. (Bexprl 

ThiH function attempts to Interpret a string as a real or an Integer, 
rc-turnlng the value of that number. 

^'^' f 1 tat character of the string must be a possible item In a number 
(]t<adlng spaces are acceptable), or t Is returned. £ach character 
ihrreartet is lllcewlse exainlned, until the first definitely non-numeric 
rhnracter Is encountered (intervening spaces, decimal points, + and - slgna, 
nnd K are ail possible numeric characters In the correct context). The 
first non-numerlr charaeter and all subsequent characters are ignored, and 
the string to that point is evaluated as a ri^al or an integer. 

II ij utrtng concatenation consisting of ntore than 255 chflraetera is the 
flrKum^-nt of VA1-, the message 
»srRINC TOO LONG ERTICffl 
in gjven. 

li the ahaoluce value of the number returned is greater than IE38, or tf the 
miFbher i-ontains more than 38 digits {incl«dln.g ctalltng zeroes}, the mesaage 
JitVEht'l-OH ERROR 
in prL-^L-nled. 
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CHR; (aexpr) 

A function that recutns the ASCII chacaccer which carresponds to the value 
ai aenpr. \aexpr\ must be between and 255, inclusive, ot tlie message 
ULLE&AL QUANTITY ERROR 
appears. Reals are canverted co Intesete- 



ASC Im & def 

ASC (aenpT) 

This function returns an ASCII code (not neceaaarily the louest number) for 
the first character of \sexpr\. ASCII codes In the range 96 through 255 
will generate characters on the APPLE «hlch repeat those in the range ^ 
through 95. However. alcViough CKRSCbS) returns an A and CKR$(t93) also 
retiicn» an A, APPLESOFT does nOC recognize Ctie two as the same diaracter 
wtien using string logical operators. 

If a string Is the argument, it fliiiac be enclosed In quotation marka, and 
iiuotation mOCks may not be included within the string. If the string is 
null, the message 
?1LLEGAL qUANTITY ERROR 
Is giveiii 

An attempt to uae the ASC function on Ctrl ? results In the 

? SYNTAX ERROR 

oessagei 



LEFT$ Imci S dtf 

LEFTS (sexpr, aexpl) 

This function returns Che first (leftmoBE) Wxpr\ characters of \ecKpr\: 

PRINT LEFT«("APPLES0FT".3) 
APPLE 

No part of this cQiamand can be omitted, it \aexpr\<l oc \aexpr\>255 then 

Che message 

71LLECAL l^ANTITY ERROR 

ie displayed . if Uexpr\ is a real, it la converted to an integer. 

If \acKpr\ > LENCsexpc), only the characters uhUh constitute the scring are 
returned^ Any extra posltlotis are Ignaredi 

If "5" la omitted from the colEMnd name, APPLESOFT treats LEFT as an 
arlthraottc variable name and the message 
?TYP£ MISMATCH ERROR 

i» displayed' 
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Ktciir^ Una & def 

1(I<;;ht$ (aexpr, aexpr) 

Thin function returuB the last (rlghtmoet) \aexpr\ characters of \sexpr\: 

IHINT rights ("APPLESOFT" + "WARE"* 8) 
:;OFTWARF 

Ni) i»\Tl of ehia command may be omitted. If \aexpr\ ?- LEN (aexpr) then 

HlCHT$ returns the entire String' The message 

71LLEGAL QUANTITY ERROR 

1« displayed if \aeKpr\<l or \aeitpr\>Z55. 

kIOKTS(aexpr» aexpr) -Mt»$(sexpr, LEH (sexpr>+l-Wxpr\) 

l( the "S" la omitted frDm the command name, APPLESOFT treats RIGRT as an 
nrltbacclc variable Tiaoie and the message 
?TYPE HISHATCH ERROR 
In d laplayed. 



HIDS Imui k d<-r 

MIDS (aexpr, aeitprl (, aexpr2J) 

Hins tailed with two argunentE returns the Bubatrlng starting at the 
SacxprlVch character oi \sexpr\, and proceeding chrouKh Che lasc character 
of Vsexpr\. 

I-KIHT H1D5("APPLES0FT", 3> 
n.KSOKT 

KlD?(eexpr, aexpr) - RICHTS(aexpr, LEN(aexpr)+l-\aexpr\ ) 

KIDS called srtth three argunenta returns \aexpr2\ characters of \aexpt\, 
beginning with the \aexprlVth character and proceeding CO the right- 

PRINT MIDS ("APPLESOFT", 3. 5) 
PLESO 

tf \acxprl\>LEN (aexpr), then MID5 returnB a null eCrlng. If 
\nexpr I \-(-\aexpr2\ exceeds the length of \sexpT\ (or 255, che etaHimum length 
of any string), any extra ia ignored. HID$(A$, 255^255) returns one 
character if LEN(A$>-255, otherwise the null string la returned. 

IE either \aexprl\ or \aexpr2\ arc outside the rangi; 1 through 255, 
Inclua ive , then the meaeage 
'ILLEGAL QUANTITY ERROR 
iH displayed. 

If the S ia omitted Ero» Che command name, APPLESOFT treats MID ae an 
arfChnetic variable name and the message 
?Ti;pE HISHATCH ERROR 
Ih displayed. 
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STORE LmD f> def 
RECALL Imm fr titrf 

STWtE avar 
RECALL a vat 

TheBe catninands store afld recall arrays from cagsette tape. 

Array names are not scored with their values, st> an array may be read bflck 
using 3 (ilEferent name tlian Chad used with che STORE command. 

The dimensions of the array named by the RECALL, statement should be 
identical to the dimensions o£ Cite original array as it was STOREd. For 
ejcample, if an array diraensloned by DIH A(5,3,5> is STOREd, then one mlglit 
RECALL it Into an array dimensioned by DIK B(5,5,5). Failure to observe 
this will re&ulE in scrambled numbers in the RECALLed array, extra aetoe in 
the array, or the ?OUT OF HEMORY ERROR. 

In general, you will be slven the tOinr OF HEHOHY ERROR measoge only when the 

total number of elements reserved for the array being RECALLed la 

ineufflclent to contain all of the elements oE the array that was STOREd. 

DIH A(5,5,5) 

STORE A 

saved 6*6*6 elements on the cassette tape4 

DIH B(5,35> 

RECALL B 

will reSMlt In the message 

ERR 

and scrambled numbera In erray B, buc program execution will contluua* 

However, 

DlH B(5,25) 

RECALL B 

wlLl i^atjse Che 

torn OF HEHORY ERROR 

to be displayed, and program execution will cease, tn this case, array 

contained 6*26 elements — too Eew eleracTitS to contain all the elemente 

array A. 

If Ehe array RECALLed has the same number of ditnenftlons t DIM A(5,5,3) 

specifies an array of three dliaenslons, each of size b] aa the array which 

was STOREd, any of the dimenaions of the RECALLed atray may be larger than 

the correspcnditig dimension of the sTOSEd array. However, scrambled numbera 

in ttie RECALLed array will result unlesB it Ifi the last dimension of the 

RECALLed array which is Ufger than the last dimension of the STOREd array* 

In every case you will find extra seros stored in the excess elements of the 

RECALLed array, but only In this last case will you find the zeros where you 

wfluld expect then. After atoring an array with 

DIH A{5,5,5) 

STORE A 

you will find: that 

MM 6(10,5,5) 

RECALL B 

and also 

DIH B(5»lfll,5> 

RECALL & 
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both fill array B with mlxed-up numbers from array A; while 

DTH B(5,5.19> 

K el: ALL a 

works fine, with zeros in array B's extra elements. 

Wi' have discussed two "rules" for STOREing and KECALLlng arrays with equal 
numbers tfi dicnenfilons: 

]* Only the last dimension of the array RECALLed may be larger than 

the last diiacnaion of the array STtftEd- 
2. The total number of elemeuts RECALLed onist at least equal ch 

number of elementa STOREd. 
II rule 2. Is followed, and If rule It is followed for the dimensions which 
arc common to both arrays (these must be the fIrgC dim^nalons). then iMie may 
RECALL ao array with more dltnenslons than the array that was STOREd* An 
^R message is displayed, but program execution continues. 
UIM H(5,5,5.,5) 
RECALL R 

will work fine in the above eiLample (after the ERR aessage, and with many 
t-Ktr^ zeros in array B) , but 
1>IH B(5.^,3,5y 

kkcall b 

will fill array B with scratubled numbers (after the ERR message), and 

»1H B(5,5,l,l> 

DEC ALL B 

will cause the 

70irr OF MEMORY ERROR 

because the &*{i*Z*2 elements in array B are fewer than the 6*6*6 eleioentH 

STOREd In array A, 

Only teal and integer arrnya may be stored^ String arrays must be converted 
to an integer array using the ASC function In oi^der to be Stored. 

Although STORE and RECALL refer to their variables without mention of 

nubaerlpt or dimension, only arrays may be STOREd or RECALLed, The 

program 

104 A(3) * AS 

ri0 A - 27 

i::|^ STORE A 

stores on tape the array elements Afd) through A(18> (by default, the 

array Is diiaenBioned to eleven elements), not the variable A (which equals 

27 In the program). 

Tht're la no prompting message or any other signal issued by the STORE 

Cnaitruction; the user must have che re'Corder running in record mode when the 

InHiruction is executed- A "beep" Signals the beginning Df the recording! 

and another "beep" signals the end> 

Tho program 

in DIK B(3,]3) 

i\<i & - i> 

3Z0 RECALL B 

rttflds from tape the ii* (6*U) array elements 6(0,0') through B(5,131. The 

wnluL- ni the variable B Is not ^changed. 

Again, there la no provptlnji neasage; "beeps" signal che beginning and the 

»nd "( the recording* 
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If either STORE or RECALL contains aTi arr^y name not previously DlMenstOned 

or used ulch a subscript, the message 

?alIT OF DATA ERROR 

is given- In immediate-ejcecution mode, if either STORE or RECALL refera to 

an array name that Is defined in fl deferred-execuclon program line, Chen the 

deferred-execution program line muBC have been eKecuted prior to the SIORE 

or RECALL. 

STORE and RECALL can be InterrupEeil Only by reBst. 

If Che reserved words STORE or RECALL are used as the first charactC£S of 

any variable nan*, Che comroands Toay be executed before any 

75YNtAX ERROR 

message is glv^ri- The BEatemeuit 

STOREHOOSE'^S 

will cause thfi 

?OUT OF DATA HIROR 

messagei unless an array has been defined whose name begins with the 

characters ttO. In Che later case, APPLESOFT will aCtempt to STORE the 

arrayi first you'll hear one beep, then a second; finally the message 

? SYNTAX ERROR 

will be printed as APPLESOFT teles to parse the rest of the statmenE, "-5". 

To cut ehoec Che beeps and error message you can preaa the RESET key. 

Tbe starcnent 

RECALLOUS-23ii 

wll!E cause thi 

?OUT OF DATA ERROR 

message to be displayed, unless an array has been defined whose nsne beglno 

with the characters OU. In Cht UCCer case, APPLESOFT vill wait 

indefinitely for an array to arrive from the cassette recorder. The only 

uay to regain control of the conputer is to press the RESET key. 
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CHAPTER 

INPUT/OUTPUT 
COMMANDS 



In Chapter 3, also see LOAD and SAVE; 
In Chapter 5, see STCKE and RECALL, 
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INPUT ^,.f 

INFliT [Btring ;1 var |{, var>l 

If the optional Siting is left out, INPUT prints a qusBtlon tnark and wjiUh 
for the u6er to type a number (If var le an artchraetlc variable) t>x 
cKaracterB <it war Is a scricia variable). The value of this number or 
string is put Into var. 

When the string is present » It is printed exactly as speclfledl fia qwostloo 
mark, spaces, or other punctuation are printed after the acrlng- Note thilt 
only one optional sCTlnB may be used- It must appear directly after "INPUT" 
and be followed by a semi -colon - 

INPUT vlil accept only a real or an integer as numetlt input, not an 
arithneCic expressioTi. The characters apace, +, -, t, and ttie period are 
legitimate parts of numeric input. INPUT will accept any o£ thefle 
characters or any concatenation of these characters in acceptable form (e.^, 
+E- ie acceptable. +- is not); such input by itself evaLuatee as p. 

In numeric Input, Spaces in any position ate Ignored. If numeric input 

which Ib not real, sn integer, a comma or a colon, the neasage 

?RE ENTER 

ie diBplayed and the INPUT instruction re-eKCCuted- 

If ONERR GOTO is used, with another GOTO in the error handling routine to 
return the program to the offending INPUT statement, the 86th IHPUT error 
raiy cause the program to Jump to the Mooltor. To recover, use reset ctrl C 
return. This problem cfin be avoided by using RESUME to return to Che INPUT 
stateioent. 

Similarly, a response' assigned to a string variable must be a single string 
or literal, not a acting expression. Spaces preceding the first character 
are ignored. If the response ia a string, then a quotation mark anywhere 
within the etring will cause a 
7R.E ENTER 

mesBage. However, within a string, all elia?acterB except the quotation 
mark, Ctrl X and Ctrl M are accepted as characters for the string. This 
includes the colon and the comma. Spaces following the final quotation mark 
are ignored. 

IC Che response ia a literal, then quotation marks are accepted as 
characters in any part of the literal eitcept the first non-space character. 
Spaced following the last character are accepted as part of the literal- 
However, the comma and the colon <and Ctrl X sod Ctrl M) are not accepted as 
characters in the literal- 

l£ the user almply presses the RETURN key when a rtufceric response is 

expected, the message 

? REENTER 

Is printed and the INPUT instruction Is re-executed. If the EETUHN key 

alone la typed when 9 string response ia expected, the response Is 

interpreted as the oull string and program execucioo continues. 
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Succeasive variahles get aucces&ively typed values. String variables and 
nrlthmetic variables nay he ulxect in the aacie INPUT statement, but tlie 
user's responses must each be of the appropriate type. The typed re&ponseB 
may be separated by coniaas or returns. As a result, if a user types comaias 
In a response that does not begifi with a quotation mark, the conmas are 
interpreted as response separators. This: la true even when only one 
response is expected' 

IE a colon is typed In an INPUT response that does not begin with a 
quotation isark, all characters typett fiubdequently are ignored- After a 
colon, conuoas are also ignored, so the start of another response tnust be 
sljgnaled by a return. 

If a return is e:ncountered before all the var's have been assigned 
n.-Hiponses, two question marks are printed to Indicate that an: additional 
response is expec ted. When a return Is encountered , if the response 
cantains more response fields than the statement expected, or 1£ a colon 
OKlstS in the final expected response (but not within a string), then the 
RWHsage 
?EXTRA ICNORED 
In pr Inted and program execution continues. 

It a colon or a comma is the firat character of an INPUT response, the 
re-eponse ia evaluated as xero or as the null string. 

Note that in the INPUT command the optional string roust be followed by a 
imml -colon but variables must be separated by cOTHPtaa . 

Ctrl C can interrupt an INPUT statement, but only If it is the first 

character typed. The program halts when return is typed. Ap attempt to 

CONTlnuc execution after such a halt results in Che 

?KYMTAX ERROR 

mi-wHOHe. Ctrl C Is treated as any other character if it is not the first 

tharacter typed- 

TryioB to use the INPUT command in direct execution mode causes the 

VILLKCAL DIRBCT EKRO& 

mi'^saage^ 



I'M <U'i nnly 

CUT var 

Piitches a single character fcow the keyboard wichouc displaying it on the 
screen and without requiring that the RETURN key be pressed. 

The behavior of GET svar has a few surprises: 

Ctrl @ returns the null chnracter^ 

The result ol GETtlng a left-arrow or Ctrl H may also 
J^]HT as if the null character were being returned. 

Ctrl C 1b treated ae any other character; it does 
not interrupt program execution. 
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While APPLESOFT was noc designed or intended to GET values for arithmetic 

variables^ you may ua-e 

GET avar 

subject Co the following stringent limltati^na; 

j^^ GETtlng a. colon or a comma results in the 
'i^C ?EKrRA IGNORED 

^"^ meBsage, Eollowad by the return of a zero as the 
typed value. 

The plus sign, mlnud eigui Ctrl @, E, apace and the 
period all return 9 zero as the typed value* 

Typing a return or nDn-numeric input causes the 

^SYNTAX ERROR 

aessage to be dlsplsy>ad. 

Wlch ONQtR COTC.RESUHE, two consecutive GET errors 
Hill cause rhe system to hang until RESET i& pre^eied* 
If GOTO Is substituted for RESUME, all is well until 
the 43rd GET error {in any ordet), when the program 
Jumps to the Monitor. To recover, use 
reset ctrl C return. 

Because of these limitations, ic Is recommended that serious programmers GET 

iiiiiDber& using 

GET svar 

and convert the resulCing string to a nucu'ber using the VAL function. 



DATA def only 

DATA [Mteral I string I teal I Integer] |{, (literal [strlnglreal lintcgeri >] 

This statement creates a list of eleinenta which can be used by READ 
statements- In order of instruction line number, each DATA stacenieot adds 
Its elements to the Hat of eleaema built up by the programe'fi previous 
(louer line number) DATA statemenCB* 

The DATA statement does not have to precJide the REAQ scatciaent in a program; 
DATA statements can appear anywhere Chroughout the program. 

DATA cleraents which arc READ Into arithmetic variables generally ftilloM the 
same rules hb for TtJPUT respoi^ses assigned to arithmetic variables* 
However, the colon cannot be included as a character in a numeric DATA 
eLenent • 

If Ctrl C is a DATA clement, Ic does not stop the program, even when it is 
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the flrac character of an element. Uith this exception, DATA elementB uhich 
are READ Into string variables follow the same rules as for IKPDT responses 
jiHnljincd to string variables: 

Kicher strings or literals may be used, or both- 

£pacc& before the first character and following a string are always 
Ignored. 

Any quotation mark that appears within a Htrinn, causes the 

ISYNTAX ERROR message, but all other characters are accepted SB 
characters In tbst string, including the colon and the comma 
(but not including ctrl X and ctri H). 

1( an element is a literal . then the quotation mark Is accepted as a 
valid character anywhere in the literal except as the first non-apace 
character; the colon, the commas ctrl X, and Ctrl H are not accepted. 

Ri't- INPUT for more details. 

DATA elements may be any mixture of reals, Integers^ strings and litE^rals- 

[| the BEAD statement attempts to aBslgn a DATA eleoent that is a string or 

a literal to atl arithmetic variable, the 

T SYNTAX ERROR 

moBHage is given for the appropriate PAIA line. 

If the list of elements In a DATA Statement contains a "non-existent" 
olement, then a zero {oumetic) ot the null string is returned for that 
element depending on the variable to which the cleinent is assigned. A 
"m»n-exi8tent" element occur* In a DATA flCatement when any of the following 
Is true: 

1) There is no ni>n-space cbsracCer between DATA and return. 

2) Comma is the fJrsi non-apace character following DATA. 

3 ) There is no- Cion-space diBractcc between two commas ■- 

4) Comma is the last non-space character before return. 

So uhen this statement is READ 

199 DATA., 

It can return up Co three elements conslstlikg of zeros or null strings. 

Wlicn used In immediate execution aode, DATA does not cause a SYNTAX ERROR, 
but Its data elements are not available to a READ statement. 



RI"J\D inn i i\ot 

HEAD var K.varH 

When the first READ staceinent ia executed Jo a program, its first variable 
takes on the value of the first element in the DATA list (the DATA list 
consists of all the elements from all the DATA statements in the stored 
pn^grad). The second variable (If there Is onel takes On the value of the 
second clement tn the DATA Hat, and so on. When the READ statement 
finishes execution. It leaves a data list pointer after the ld6t element 
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of data used. The next &EAD statement executed fif any) begins using th& 
data list £roni the positt'On of the poitiLer. Either RUN or RESTORE aeEa the 
pollster to the first elemBnt in the DATA list. 

An attempt Co READ more data than the data list contains producea the 

nieasBge: 

70UT OF DATA ERROR IN linemim 

where llncnum la the line number of the BEAD stateinent which salted for 

additional DATA. 

In immediate mode* you cdn only READ elesiencs from DATA statements which 

exist as lines In a currently Stored prc^raa. The elementa of MtA In 

stored prografii can be READ even IE the scored program has not been RUN< If 

no DATA statement has been scored, the message 

TOUT or DATA ERROR 

is displayed- Executing a pragtam in lunied ia te mode does not set the data 

list pointer to the first element In the DATA list. 

Extra data left unread Is OK. 



RESTORE Imra h def 

RESTORE has no parajnetere or options. This ecatement merely noves the data 
iist pointer (see the READ afid !)ATA statements) back to the beginning ot Ch» 
data li&C> 



PRINT Ian J> del 

FHINT lU%pt) [(.I; t<eKpr}Ul) [J;I 
PS.INT {;) 
FRINT <,) 

The question mark ( 1 ) may be uBed as an abbreviation for ^IHT^ It LISTe 
as PRINT. 

Without any options, PRINT cauaea line feed and return to be executed on tli« 
screen. When options are exercised, the values oE the list of Che apeclfied 
expreaalona are printed. If neither a consaa nor a semi-colon enda the lint, 
a line feed and return are executed following che l«at item printed.^ If en 
Itea on the list U followed by a comma, then the first character of the 
mext item to be printed will appear in the first position of the next 
available cab field. 

The first cab field comprises the leftmost Id printing paaitionS In the text 
window, positions 1 through 16, The second tab field oceu^tea the next 16 
positions (17 through 32), and is available for tab-field printing only If 
nothing la printed in position 16< The third tab field consists of the 
remaining S printing positlDna 03 through 4'(1)» and Is available only If 
nothing is printed in pOSitlone 24 through 32. 

The Bize of the scrolling window for text may be changed using various fOKK 
cosmands (aee Appendix ■!)• 
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The PRITTT tab field 3 does not function properly if Che text window is set 
CO less than 33 positions wide; Che first character may be printed outside 
the text window. HIAB can also cause FKlNT to display a first character 
outside the text window. 

If an item on the list is followed by a semi^colon, then the next Item la 
(^oneatenaced: It Is printed directly afterward with no intervening spaces. 

IteuB listed without intervening commas or semi-colons are concatenated If 
the Items can be parsed without syntax problems. This Is best Illustrated 
by cx&Bples! 



A-1 



B-2 



C-3 : C(4)=5 : C5-7 



FHIRT l/3{2*ii)51 
.333333333851 

PRINT 3.4.5.6. , 
3.4.5.60 



: FItlTJT UA)2(B)3C(4)C5 
1122357 

! PKINT A*"B."C.4 
LffB. 3. 4 



PRINT works very hard to figure out what you want. If It can't interpret a 
period Si^ a decimal polntt it treats it as the number S, as illustrated In 
the above e^taniplea. 

PRtMT followed by a list of semi-colons does nothing more than PBl!Hr alone, 
but it is legal. PRIKT fallowed by a list of commas spaces one tab field 
per comma , up to a limit of 239 characters per Instruction. 

PRINT AS+BE 

gives a 

7STI11J1G TOO LONG ERROR 

if the length of the concatenated strings Is greater than 253. However^ you 

can print the apparent concatcination using 

PBltJT AS B$ 

without worrying about its leAgch* 



[N If! (. def 

IHf aexpr 

Selects Injiut from slot \sexpr\. Used to specify which peripheral will be 
providing Input for subsequent IKFOt scateinents. Peripherals may be In 
slots 1 through 7, as Indicated by \aexpr\f 

INf Indicates that subsequent Input will be from the keyboard Instead of 
the pcrlphecal. Sloe is not addressable from APPLESOFT for use with a 
peripheral device. 
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If no peripheral la in slot \aexpT\, the system will hsng. To tecovtr, uHy 
reeec ctrl C return. 

If \aexpr\ £s less than i or greater than 255, Lhc ae9sa£^ 
?ILLEGAL qUAUTITY ERROR 
Is displayed. 



(^ 



t£ VaexprV Is 1ti the range 8 through 255, APPLESOFt ts altered In 
unpredictable ways. 

For siallar tranflter of output, see PR** 



'I'* 



The nessflge 

?TYPE HISHATCH EKROB 

is displayed It you try to give 

^) a string variable name to an arithmetic exprcBslon, oc 

b) a string variable name to a literslT ■Jr 

c) an arithmetic variable name to a string expreaaion* 

If you try ct> give ao arithmetic variable name to a literal, APPLESOFT 
atteiopts to parse the literal as an arithmetic expressioni 



nrr dof 



PHf Intn t. def 

PRS aexpT 

PR* transfers output to slot \a«xpr\» w*iere \aexpr\ nuat be In the range 1 
CO 7, inclusive- 

PR# fl returns output to the TV screen, not to bIoC 9- 

If no peripheral Is In Che apecified slot, the syGCem will hang- To 
recover, use reset Ctrl C return. 

If \aexpr\ Is less than 9 or grenter than 255, the aessage 
TILLEGAL Q13ABTITY ERROR 
Is displayed. 



r^ 
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If \aexpr\ [e lo the range 8 through 255, APPLESOFT ie altered in 
unpredictable vays. 

For similar transfer of input, see IH#. 



LET Imra fc .U-f 

(LET! avat [Bubscript] ■ aexpr 
[L£T) svar [subscript] - sexpr 

The variable name on the left is ftsaigned the value oi the string or 

expression on the rights, the LET Is optional! 

LET A-2 

and 

A-Z 

are '■equivalent. 
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DEF FN name (jrieal avav) ~ aexprl 
FN name Caexpr?) 

Allows user to d<c£ine Eunctlona in a program* Fire't the function FK Aain$ l9 
defined using DEF. Once the program line DEFtrtirta th* function has been 
executed , the functisn may be used In the form FN name (argument) where the 
argument aexpr2 nay bo any arithmetic enpreasion. The DEFinition's aexprl 
may be only one program line in lengCh; Che defineil FN name may be uaed 
wherever arithmetic functions may be used In APPLESOFT. 

Such functions ctay be reDBFlned during Che course of a program. The rules 

for uelng arithmetic variables still applyi In particular, the first two 

characters of name must be ynlquc When these lines 

m DEF FN ABC(1)-C0S(I> 

20 DEF FN AST<i>-TAN(I> 

are executed, APPLESOFT recognizee the definition of an Fll A& function lu 

line 19; In line 2||, che FN Afi funcctcft is redefined- 

IiV che DEF inscrucclon, real avar is a dummy variable. When the 
user-defined function FN name is used later, it is called with an argument 
aexpr2- This argument is substituted for real avar wherever It appears in 
the definition's aexprl- acuprl may cuntaln any number of varlobles . buc 
of oourse only one of those Cat nose) corresponds to the dumii^ variable real 
aVar, and therefore correspdnda to the arnument variable. 

The DEFinlClon'a real avar need not appear In aexprl. In that case, when 
the function, ts uaed later in the program, the function's srguraent Is 
ignored in evaluating aexprl* Even in this case, however, the function's 
argument is evaluated itself, ao it nust be something Legal. 

For instance: 

100 DEF FV AfV) - I * U + V 

110 PRINT FN A(23) 

120 DEF FN B(X> -4+3 

UO C - FN Il(23> 

140 PRINT C 

150 DEF FN A(y> - FN B(Z> + Y 

160 PRINT FH A(G) 
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RUN 
69 

7 
14 



[ FH A(a3)-2*2>t-23 ] 
I FN B(anythlng)-7 1 
( new FN A(7)-7+7 ] 
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If a deferred-execution DEF FN name statement Is not executed prior to iinlnR, 

FM name, the 

^UNDEF'D FUKCTION ERROR 

meB&sge la displayed > 

User-definecJ stcLng functiotia are not allowedp Functions defined uBlnR in 
Integer namel fot name or for real avar are not allowed. 

When a new function ia defined by a DEF atdtementj 6 bytes in, memory are 
used to store the pointer t*? tbe definition. 
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CHAPTER i 

COMMANDS RELATrNG 
TO FLOW OF CONTROL 






76 GOTO 

7« tr...THE:H and I?... GOTO 

?3 FOR, .,10, ..STEP 

79 HBXT 

79 cosi;b 

80 RETIittN 
84 POP 

81 ON,,. GOTO and ON...G0$Uft 

81 ONERB GOTO 

82 RESimE 
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GOTO imm S def 
GOTO linenum 



Branches to tht line whose Il^ie number Is linenutn. IE there Is tio Huch 
Itne, or if linenum is absent from the GOTO sCacemenC^ then the message 
rUHDEF'D STATEMETrr ERROR T« linenum 

is displayed, vherc linenum is the linie number oE the program line 
containing the GOTO statenent. 



IF intit & dcf 

IF 6xyr TKEK Instruction [<: inac ruction)] 
IF expr THEN (GOTO] linenum 
IF BKpr [THEHl GOTO linenum 

If expr la an arlchmetlc expreasioti whose value ia not zero (and whose 
absolute value Is greacer than about 2.q3a?3E-39) , \expt\ is consldei-ad to 
be crue, and any Instructlon(s) folLowing THEN are executed^ 

If expr is an arithmetic expression whose value la zgto (or whose abaolut* 
value 13 Uss than about 2. 93ft73E-39>, any Instructions following THEN are 
ignored^ and execijition passes on to the instruction in the next numbered 
line of the program. 

tfhen the IF statement occurs in an immediate execution progratn, if \expr\ Is 
aero, APPLESOFT will Ignore Che enClre remainder ot the program. 

If expr is an arithmetic enpreaalon involving string expreaslona and string 
logical operators, expr Is evaluated by comparing the alphabetic ranking of 
the Btrina expressions aa determined by the ASCII codes for Che characters 
involved (see Appendix K), 

Statements of the form 

IF expr THEN 

are validi no error loeasage la printed. 

A THEN without a correspondltia IF or an IF without a THEN will cause the 

mess age 

2 SYNTAX ERROR 

to be di&played. 

APPLESOFT was not designed or Intended to allow che IF statement's expr to 
be a string expression, l>gt string variables and strings may be used as expr 
under the following stringent conditione. 

If expr is a string expression of any kind» then \expr\ is non-zero, even IE 
expr ia a string variable which has been aaaigned no value or *'(*" or the 
null string, "". However the litetal null Birlng» aa in 
IF "" THEM ... 
evaluaceB as zero- 
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IF string THEN... 

when executed more than two or three tinea in a given program, causes Che 

message 

■*FOKHULA TOO COMPLEX ERROR 

to be printed. 

® 

If expr is a string variable and the previous statement assigned the null 

string to any string variable, then \expu\ evaluates as zero. For 

Instance, the program 

123 IF AS THEN PRIST "A$" 

lifl IF fiS THEN PRINT "B$" 

li9 IF XS THEN PRINT "XS" "" 

when Rira, prints 

AS 

BS 

XE 

because strings A$, B$ and X$ evaluate as non-zero- Houcvett adding che 

line 

109 q 9 - "" 

causes all 3 strings to evaluaCe as zero, and no output is printed- 

Deleting line 109', or adding almost any line 110, such as 

llfl F - 3 

causes all 3 strings to evaluate as non-zero again. 



^ 



Before THEN, the letter A causes parsing problems: 

IF BETA THEN 23fl 

parses to 

IF BET AT HEN23fl 

which generates a 

TSYNTAX ERR(B 

message or execution. 

These are equivalent; 

IF A-3 THEN 1 &0 

IF A-3 GOTO 160 

IF A-3 THEM GOTO 160 
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FOR Ian & dcf 

FOR real avar - aexprl TO aexprl [STEP aexprSJ 

\avar\ is set co \aexprl\, and the stat^menta following the fOE are execuCod; 
iiincll a statement 
NEXT avar 

Is encountered, «Viere avar 1b Che ssme name as appears In the FDH ataterapnt. 
Then \avar\ Is tnereroented by \aexpr3\ {\ae)ipr3\ defauUe to [). Next 
\flvar\ Is campared to \aexpr2\. aM If VavarS>\aexpc2\. execution procecda 
with the st^atemeTit following Che NEXT^ IE \avar \<-\aexpr2\ , sKecutlon 
proceeds from the etaceioent follOMlng the FOH. 

If \aexpr3\<(J then operation is aliRhtly different after \aexpr3\ is added 
CO \avar\. IE \avaf \<\aexpr2\, execution proceeds with the statement 
followinR the NEKT, If \avar\>-\aexpr2\^ then execution proceeds tiaa the 
atateaenc follovlng the FOR. 

The arlchmeclc cxpteHsions which forra the pafatieters of the FOR loop way bc 
reals, teal variables, integers, or IntCfter variables. However, real avuf 
mugC be a real variable. An attempt to use an integer variable for real 
avar results in the 
?SYHTAX ERROH 
meaSdge- 

As \avar\ is Incremented and compared to \aeKpr2\ only at the bottom of Che 
FOR. ..NEJCr loopp the portion of the program inside the loop is always 
executed *C least once. 

FOR...HEXT loops must not "croBs" each other. If they do, the measage 

^NEjrr wiTHoyi fob error 

will be pcinced. 

If FOft loops are nested more than 10 levels deep, the 
?OUT OF MEMORY ERROR 
message is displayed. 

To run a rOR...HEXT loop Id immediate-execution nodet the FOR acacement and 
the NEXT statement should both be Inclu^ded In the aarae line (a line is up to 
239 characters long>. 

If the letter A is used iioraedlately prior to TO, do not allow a space 
between the T and the 0* FOR I-BETA TO 56 la fine, but FOR I-BETA T 56 
parses as FOR l-BET AT 056 and geca a 
?SyNTAX ERROR 
fin execution. 

Each active FOR. . -NEXT loop uses 1& bytes In memory. 
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SFKT ivm & def 

KEKT tavar] 

NEXT avar [<,avar}] 

Forns the bottoni of a FOR NEXT loop. When a NEXT is encountered, the 

program either ignores it or branches to the statement fnllowlng the 
corresponding FOR, de^enijing on the conditions explained in the discussion 
of the FOR statement. 

Multiple avars must be speciEied in the proper ordet so FOR... NEXT loops ate 
nested inside each other ^nd do not "cross over." Incorrectly ordered avars 
will cause the message 
?NEXT UITHOUT FOR ERROR 
to be printed. 

A NEXT statement in which no variable name la specified defaults to the Dost 
recently entered FOR-loop that is still in effect. If no FOR stateraent With 
the same variable nflroe Is In eflect. Of if fiO FOR stateaient of any naute Is 
In effecC uhen s Tianclees NEXT is encountered, the message 
?NE)CT WtTKOUt FOR ERBOft 
is printed. 

NEXT without avar SKecutea more rapidly than does NEXT avar. 

In intwdiate-eicecution mode, the FQR scatenent and its corresponding NEXT 
Qtatement Should both be executed in the same line. If a deferred-execution 
FOR atatecnent Is still In effect, an iTDmed late-execution NEXT statement can 
cause 8 Jump to the deferred-execution program, wKere appropriate. However, 
if the FOR statement was eKecuted in intnedlate execution, a NEXT statement 
In a different immediate-execution line will CAUse the 
?SYHTAX ERROR 

unless there are no intervening linea and the NEXT stands alone and 
nameless: 

IFCW I - 1 TO i : PRIHI I 

[ 

JNEXr 

2 

)HEXT 

3 

)NRXT I 

ISyNTAX ffiROR IN xxxx <xkxx is Botne line number) 



COSUK Imm h def 

i»SUB linenutn 

TItC! program branches to the indicated line. When a RETURN statement is 
i-x(-ruted, the program branches Co the ataCemcnt iDmiied lately following the 
noat recently executed fiOSUB. 
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Each time a GOSUfl i& executed, the address of Che EollowlTig statement irt 
storeti on top of a "stack" of these ad<iresses, sa the progratn can later find 
its way back- Each time a RETURH or a POP is executed, the top addr*ttfl In 
the RETORH "stack" is removed. 

If Che indicated llnenuni doea not correspond to an existing progrfln line, 

th& error message 

'UNDEF'D STATEMENT ERROR IN tinenum 

is giveni where litieouffl Indicates the program line containing the GOSUB 

stateitent. The 

IS Linenvn 

portion o£ the message is omitted if OOSUB ia used In direct execution mode* 

It GOSUBh dre nested nore than 25 levels deep, the message 
!OUT Of MEMORY ERROR 
is displayed ■ 

Each active GOSUB (one that has not RETURNed yet) uses 6 byteS o£ memory. 
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.JH..,UUTO def 
i)N... GOSUB def 

OH aexpr GOTO lioenum {[, linenumH 
UK aenpr GOSUB linenuin {[. llnenuw]) 

ON. ..GOTO branches to the line number GpeclFle>d hy the \aexpr\th Item in the 
list of llitenums after the GOTO. ON. ..GOSUB works in a Bimilar fashio:^, but 
4 GOSUB rather than & GOTO Is exeeutetl. 

It \aGxprV is or greater than the number of listed alternate llnenums but 
leas than 255, then progratt execution proceeds to the next scatement. 

\aeiiptl\ mu&t be in the range to 255 to avoid the nesaage 
TILLECAL QUANTITY ERROR 



OKKHR nnrn rt^f -nlv 



RETURN iBoi k def 



RETURN 



There are no paraneters or optloms in this camra^nd. This ie a branch to tliv 
statement that Immediately follows the raost recently executed GOSUB. The 
address of the statement branched to is the top one on the RETURN "stack" 
(see GOSUB and FOP). 

If a program encounterB RETURM statements once more than it has encountered 
COSUS statements, the message 
7RETURN WITHOUT GOSUB ERROR 
is presented^, 



POr iBcn (. def 
POP 

There are no parameters or options aesociflted with TOP. A POP hae the 
effect of e RETURN wlthaut the branch. The next RETURN encountered, instead 
of branchtns to one statement beyond the raflst recently executed GOSUB, will 
branch to one stacanent beyond the second most recently executed GOSUB, 
It ifl called a "POP" Since It pops one address off the top of the "stack" of 
RETURN addresses. 

If POP Is executed before a GOSUB has been encountered, then the message 

?aETURN yiTHoirr gosub ersor 

is displayed because there are no return addresses an the stack. 
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OHERR GOIO linenura 

W]iicn an error occurs, OHERR GOTO may be used to avoid having an error 
message printed and execution halted. The comcisnd sets a flag that causes 
an unconditional JuBp (if an etcor occurs later in the program) to the 
program line Indicated by llnenunii POKE 2E6, (f resets the error-detection 
flag so that normal error messages will be printed. 

The OMERK GOTO sCatement must be eMecuted before Che occucance of an error 
to avoid program Interruption. 

When an error occurs in a program, the code Cor the type of error la sccred 
in decimal memory location 222. To See uhlcli etrot uas encountered, PRINT 
PEEK(222}. 



Code Error Hessage 



16 
22 
&2 
53 
69 
77 
99 
107 



NEXT without FOR 

Syntax 

RETURN uithotit GOSUB 

Out of DATA 

Illegal Quantity 

Overflow 

Out of Hemory 

Undefined Statement 

Bad Subscript 



Code Error Hessage 

120 Redimensioned Array 

133 Division by Zero 

163 Type Hlemfltch 

176 String toa Long 

191 Formula To^ Complex 

224 Undefined Function 

25^ Bad Respon&s to INPUT Statement 

23^ Ctrl C interrupt Attempted 



^ 



Lare qusc be ta)ten when handling errors that occur within FOR... NEXT loops 
or between GOSUS and RETURN, as the pointers and RETURtl stacks disturbed. 
The error-handling routine must restart the loop, returning to the FOR or 
GOSUB statement t not Clie NEXT or RETUKH Btatement. After error handling, 
a return to a NEICT or a RETURN will cause the appropriate message: 
TNKXT WITHOUT FOR ERROR or ?RETURN WITHOUT GOSUB ERROR 
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Uhen OHNERR GOTO is uaed with RESUHE Co handle errors In a GET gtatemenc, 
the ptogrsEi will "hang** If chere are t«cj cpnsecutlve GET errors without an 
intervening siicc«Bsfui GET- To i^scape^t use reset ccrl C return- If GOTO 
ends the etror -hand Hog routine, everything works fine {but see next note). 



^ 



When used In TftACE node or in a program containing a PRINT statement. ONERK 
cjiuseB a juTnp to thd Koiiitor after 43 errors are encowOCered. Where these 
errors are Bencrated by an INPUT statement, everything works fine IE RESUME 
is used; but if GOTO eTids the error-handUnB routine, tKe 87th INPUT error 
causes a Jump to the Hoilicor. Again, reset Ctrl C return wJll get you back 
to APPLESOFT. 



IC you are bothered liy any oC tiie problems Ju5t ^Hscusseid, execute a CALL to 
the following assembly-laflguage aubroutlTic as part o£ yout etror-hatidiinR 
routine. 

tn the llonitor, enter Hex data: 68 Afl 68 A6 BF 9A AS 98 ii6 6fl 

or in APPLESOFT, enter Oeclmal data: Itfii 163 i(lA 166 223 i5i 72 152 72 96 

For example, in APPLESOFT you could POKE the decimal nute&era Into locations 
76* through 777. Then you would use CALL 766 In your error-handlltig 
routine. 



RESUm dot 
RESUME 

Uhen used at the end of an error handUHB routine, causes the program to 
resume execution at the beginning of Che statenent in which an error 
occur redo 

If RESUME Is encountered hefore an error occurs, the 

7SYHTAX ERROR IN 65^27S 

nessage may be giVL^n, or other Strange events may transpire- Usually, youc 

prograiawill be stopped or it uHJ *'hang." 

If fln error occurs in an error handling routine, the use oi REStIHE utll 
place the program In an Iftflnice loop. Use reset cirl G cetyrn to escape. 

In Inmediate^^executlon mode, Kay cau^e the syBtem to ^'hang," may cause a 
SYNTAX EflROil, or any begin executing an existifig or even a deleted prograniT 
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GRAPHICS AND 
^ GAME CONTROLS 
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^^P*'' L.OW ReBolutlon Graphics ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^H 

^V COLOR ^^^^^^^^^^^^^^^^^^^^^^^^H 

^9" PLOT ^^^^^^^^^^^^^^^^^^^^^^^^1 

^9- VLIN ^H^^^^^^^^^^^^^^^^^^^H 
^9- 87 SCRN ^^^^^^^^^^^^^^^^^^^H 


E- 


^V'l Kigh-resoluciod Graphics ^^^^^^^^^^^^^^^^^^^^^^| 
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^9^ Caaie coatrole ^^^^^^^^^^^^^M 
m^ POL ^^^^^^^^^^H 
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TF.XT imra h def 



TEKt 



No parameter^' Sets the screen Ca th^ usual full-screen texc mDde (44 
characters per Line. 2^ lines) from low-resoliitipn graphics mode or either 
of the twQ hlgh-resDlution graphics mddea. The prompc and cursor are moved 
CO the last line of the screen. If issued In text mode, TEXT is eqyiveient 
to VTAB Z4. 

A Btatement such as 

irS TEXTlt.Ecl27 

causes execution of the reserved word TEXT betore the 

? SYNTAX ERROR 

message appears. 

If Che text window has been set to anything other than full scrcan (Bee 
Appendix J). TEKT reacts to £ull Screen. 



CR jimn & def 

GR 

No parameters. This command sets low-resoliitLcn CRaphlcB mode (4() by ^9) 

Cor the screen, leaving four lines for text at the bottom. The screen Is 

cleared to black, and the cursor Is moved to the text uindcu- Can be 

coovtrteii to full-screen (40 by 63) graphlca, -after exeeutlna ^* vrith the 

commard 

K)if£. -1&3(I2,|I 

or the equivalent command 

POb^ 492 34,0 

IE GR follows a full-screen POKE command, mixed CRaphica-plua-text mode la 

reset* 

After a GR conuiand » COLOR haa been Bet to itSCO. 
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It the reserved word Ck ts used as the first characters of a variable name, 

the CR may be executed betorc you get the 

?SYHTAX ERROR 

message. Thus, executing the statement 

GRlH-5 

leaves you with an unexpectedly darkened screen* 

If Igsued while H,CR Ib In effect, CR behaves normally. Kovever, if Issued 
while HGR3 is in effect, CK cliCars Its usual screenful of memory, but leaves 
you looking at page 2 o£ low^resolution afgphica find text. To return to 
normal mode, simply type TEXT. In programs, use TEXT before swicchlng from 
UCR2 to GR. 
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i:(JUm inm b def 

COLOR ' aexpr 

Sets the color for plotting in low resolution graphics mode. If \aBxpr\ Is 
a real. It Is converted to an integer. The range of vdlu«s for \afixpr\ is 
from through 255; theae are treated modulo 16. 

Color names and their associated numbers arc 

black 4 dark green 8 broun 12 green 

1 magenta 5 grey 9 orange 13 yellow 

2 dark blue & mediun blue 1(9 grey 14 aque 

3 purple 7 light blue U pink 13 white 

COLOR is set to itero by the CR command. 

To find out the COLOR of S given point on the Screen, use the SCRH command. 

When used In TEXT tnod^, COLOR is one Eaetor In determining which character 
is placed on the screen by a PLOT Instruction. 

If used while In High- resolution CRsphlcs mode, COLOR is ignored. 



PLOT iTnni h iSat 

PLOT aexprl, sexprZ 

In loM-resolution graphics mode, this coimaand places a dot with x-eoordinate 
\aexprl\ and y-coordinate \3expr2\. The color of th* dot La determined by 
the most recently executed C01J)R statenent CCOLOR-fl if not previously 
specified). 

Vaexprl\ must be in the range H through 39, and \aexpr2\ must be in the 
range 9 through 4' of the nesaa^e 
71LLEGAL QUAKTITY ERRtSl 

appears. 

An attempt fa PLOT while the aysten Is In TEXT mode, or in mixed 
CRaphicH-pliie-tcj^t mode with \aexpr2\ In the range 4S to 47, will reeolt in 
a character being pldceH where the colored dot would have appeared. (A 
character occupies the space of two low-resolution graphica dots stacked 
vertically. ) 

The command has no visible effect when used in 3IGR2 High-resolution graphics 
tndde, even if preceded by a CR command, as the screen la oot "looking at" 
the low-resolution graphics portion (page one) of memory. 

The origin (0,0) for all graphics is In the upper left corner of the 
screen » 
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KI.in Iram b def 

HLIN aexprlt aeKpr2 AT aexpr3 

Used In low-resolution CAaphlcs mode, HLIN draws a line from 
(\aeKpTtV,\aexpT3\} to <\aexpr2\,\aexpr3\}> The color la decermliiecl by the 
iDOSt recently executed COLOR &latement< 

\aexprl\ and \aexpr2\ must be in the range 9 through 39, and \aexpr3\ must 

be in the range 9 through 47^ Qt the io«89age 

? ILLEGAL <JUANTITY EHBOR 

appears. \aexprl\ may be greater chan^ equal to, or Jiess than Va6NpE2\. 

If HLIH Is used when the system Is In TEXT mode, or In mixed 
GHaphicB-plus-texiL tnade with \aBxpr3\ in the range Ad through 47, then fi 
line of chacactcts will be placed vhere Ehe line of graphic dots would have 
been plf>Eted. [A character occupies the space of tua low-reaclution dots 
stacked vertically.) 

The command hae no visible e££ect when used in high-reBolutton graphics 
mode* 

Koce that the "H" In this command refers to "horl^^ontal" ^nd not 
"biigh'-reaolutian". Except for BLIH and HTAB, the prelln "H" refers to 
hlgh^resoluClDn Instruction^. 



VI.IH imin f, dcf 

VLIN aexpri , aexpr2 AT aexprS 

In lou-reiolution GR^phlcs Diodfi, draws fl vertical line from (\aexprl\, 
WexprJX) to (\acxpr2\, \aexpr3\). The color Is determined by the Dost 
recently executed COLOR Statement. 

\aexprlV and \aexpr2\ muat be In the range through A7, \aexpr3\ must be fn 

the range 4 through 39, or the message 

?ILLEGAL qUAHTlTK ERRCffi 

is displayed. \aexprl\ vHf hi greater than, equal to, or less than 

\aeiipr2\. 

IE the system Is In TEXI mode when VLIN ia used* or In mixed 
CTtaphlcs-plua-teKC with Vaexpr2^ In the range i0 through 47, the portion of 
the line within the text area will appear as a line of characters, placed 
where the graphic dots would have been plotted. 

The comnand has no visible effect when used In hlgti-resolutlon gEaphlca: 
node. 
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SCHN limu h def 

SCRN (sexprl, aexpr2} 

In lou-resolutlon GSaphics node, the function SCRN returns the color code of 
the point whose x coordinate la XaexpcU and whose y coordinate is \ae5cpr2\. 

Although loH-reaolution GRaphica plots poirts ar screen positions Cx.y} 
where x is In the range fl through 39 and y la In the range through 47, the 
SCRN function accepts both x and y values In the range 9 through ^7- 
However, If SCRN Is used with an x value (\aexprl\) In the range i.^ through 
47, the number returned gives the color at the point whose x coordinate is 
(\aexpr\-4(l) and whose y coordinate Is (\aexpr2H!6). If (\aexpr2\+16) Is In 
the range 39 through 47, In normal mlxci} GRaphics plus text mode, the nuiab^r 
returned by SCRN is related to the text character at that position In the 
text area below the graphics portion nf the screen. If (\aexpr2\+l & ) Is in 
Che range fi& tlirough 63, SCRN returns a nninber unrelated to anything on the 
screen. 

In TEXT made, SCRN returns numbers In the range through 15 whose value Is 
the 

upper four bits, If aexpr2 is odd; or 

lower four bits, if ae>;pr2 is even 
of the character at character position 
(aexpci+l, INT ((?iexpr2+l )/2) ). So the expression 
CHRS (SCRN CX-1 , Z*{Y-1 ) )+l 6*SCRN (X-1 , 2«tY-l )+l ) ) 
will return the character at character position [X.Y). 

In High-resolution GRaphics mode, SCRN continues to "look at" the 
low-resolution GRaphics area, and the number SCRN returns is not related to 
the high-resolution display. 

SCRN Is parsed as a reserved word only if the next non-space character 1r b 
left parenthesis. 



HCK I mm I. Jcf 

HGR 

Ko parameters. Sets high-cesoluclon graphics node (280 by 160) for the 
screen, leaving, four lines for text at the bottom* The screen Is cleared to 
blaclc aad pa Re 1 of necnory t8K-16K) is displayed. HCOLOR is not changed 
by this commond. Text screen memory is not affected. Use of the HGR 
command leaves the text "window" at full flcreeri . but only the bottom four 
text lines are visible below the graphics. The cursor will atlU be in the 
text "window," but may not be visible unless it Is moved to one of the 
bottom 4 lines. 
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The screen can be tionvert^d to full-scceen (2B0 by 192) graphics after 

executing HGR with the POKE cDtnmand 

POKE -l«»2,(l 

or the use of 

POKE 4923S,fl 

which is equivalent.^ If KCR Eollovs a either of the above POKE co9ii&andB> 

mlK^d high-resolution grapMcs-plus-text is reSet. 
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If ttie reserved uord HQl Is used as the first chaiacters ol a variable namut 

the HCtt may be executed before the 

?SlfHTAX EBROB 

taeasage appears. Thus, executing the statement 

HCRIP-4 

results In an unexpected, trip Into high-resolution graphics madet which may 

erase your prograis. 

® 

A very long program which exCeni^s above Taemory location 8192 ray be 
partially erased whert you execwce HGR, or It may "write" Into youc page t 
hlgh-refioluclort graphics display. In particular^ string data is stored at 
the CQp of memory; on small memory ayatems (L6K cr 20K) this data nay 
reside In page i of high-resolution Rraphics. Set HIHEM: 8192 to protect 
your program and page 1 of high- resolution graphics. 



llllliUOK incm (• del 
HCOLOS - aexpr 

Sees hiBh-resolution graphics color to that specified by the value of 
HCOLOR, which must be in the range fl to 7, inclusive. Color names and chelr 
associated values ate 

black 1 4 blacW 

1 green (depends on TV) 5 (depends on TV) 
t blue (depends on TV) f> (depends on TV) 
3 Hhltel 7 uhiteZ 

A high-resolution dot plotted nith HCOLOR-3 (white) will be blue if the 
x-coordlnate of the dot Is even, green if the x-coordinatc la odd, and uhlce 
only if both (x,yj and (x+l.y) are plotted. This is due to the way horcie 
TVs work. 

HCOLOR la not changed by HGR, HCR2, or RUN. Until the first HCOLOR 
Btatement is executed, the plotting color for hlgh-reaolution graphics La 
Indeterminate. 

If uaed trtilie in low-resolucloTi CEaphlca, HCOLOR does not affedl the color 
belles displayed. 
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HCR2 imm h def 

HGS2 

No pBtaaeterSi This eommand sets full-acreeti hlgh-reaolutlon graphics mode 
(28^ by 192 5'. The screen la cleared to black, and paRC 2 of ncmory 
(J6K''24K) is displayed' Text screen memory Is not affected. This page of 
memory (and therefore the command HGR2) is not available if your system 
contains Less than 2&K of memory- On, systems that do allow it, using HGR2 
instead of HCR maximlzeB the menOry space available £or prograoiS. 

On 2AK systems,, set HIHEK: 163B4 to protect page 2 of biigh-Ecsolntion 
graphics frota your program (especially strings, which are stored at the 
top of meoory)* 



^ 



If the reserved word HCE12 Is used as the first characters in a variable 

name, the HGR^ nay be executed before the 

TSYHTAX ERRCft 

iseasBge is glvcn4 Uhen executed, a seateaent such as 

Ififl IF X > 15? THEN KGR2PIECES - 12 

leaves the screen suddenly blank, possibly with the upper reaches of the 

program erased. 

The command 

KkE -16301,0 

converts any full-screen graphics mode to mixed graphicB-plus-text mode. 

When issued after HGR2, however, the four lines of text are taken from Pttae 

2 of text, which is not easily accessible to the user- 



IIPLOT Iirmi fc del 

IIPLOT aexprl, dexpr2 

HPLOT TO Qexpr3, acxprA 

HPUOT uexprl, aexpr2 TO aexpr3, aexpr* HTD aexpr, aexpr)) 

HPLOT with the first option plots a high-resolution dot whose x-coordlnate 
ia \aexprl\ and whose y-coordlnate ia \aexpr2\. The color of the dot i6 
determined by the most recently executed HCOLOR atatewent. The value of 
HCOLOR is indeterminate if not previously specified- 

The second option causes a line to be plotted from the last dot plotted to 
(\sexpr3\, \aexprfi\). The color of this line is determined by the color of 
the last dot plotted, even if the value of HCOLOR has been changed fllnce the 
previous plotting. If no previous point has been plotted, no line is drawn. 

If third option la used, a line frofl (NaexpcU, \aflxpr2\) to (\aexpri\, 

\aexprft\> la plotted using the color specified by Che mosc recent HCOLOR 

command. The plotted line C»ay be extended in the sane Instruction alinoat 

Indefinitely (eubject to the screen llmltB and the 239 character instruction 

llmit> by entendlng the instruction with 

TO aexprS, aexprl TO aexprn?, aexprS 

and so on. The single statement 

HP1.0T »,» TO 279, (f TO 279,159 TO 0, 159 TO (*.;) 

can plot a rectangular border around all four sides of the high-resolution 

screen. 
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HPLOT muBt be proceeded by RCTf or flCR2 to ^vold clobbering Iocs of inBinory, 
litcluding, your program and vazLabl^&- 



\aeitpTl\ aDd \aexpT3\ must be In the range i tbraugti 279. 
\aexpr2\ and \aexpr&\ must W In the range 9 through 191. 
\aexprl\ may be greater tliani equal to, or Less then \9CXpr^\- 
be gT'Cater tbao* equal to^ or less than, Vaexpr-^X- 



\die»:prZ\ nuiy 



An accempt to plot a point whose coordinates exceed these ILmlts causcB tile 
21LLEGAL QUANTITY ERROR 

message. If the screen is In miKed high-reaolutlon graphics plus U lines of 
text. Chen attempts to plat points vlch y-coordlnates in the range IbH 
through 191 «ill have no visible effect. 



PDt, irniTi I. det 

PDL faexpr) 

This function returns the current v^lue, from 9 to 255, oE the game COriCrol 
(or FaDdLfi) specified by \ae«pr\. If \aej(pr\ is In the carige through 3. 
The gam* control Is a resistance variable Iron to ISflK ohms. 

If tvD game controls dre read In conSCCutlVC POL LnstructtonG, tht reading 
[rom the seeond game control may be affected by the? readlrJ^ EcaKi the flret* 
To- obtain more accurate readings, allovf seveTal program lines betveen PDL 
inStfCtiona, or place a shore delay loop (FOR 1 = 1 TO 1(J:TJEKT I) between PDL 
Instructionfi. 

If \aGxpr\ is negative or greater than 225, the 
?1LLECAL QUALITY ERROR 
me&sage is gLvctt. 

If \aexpr\ Is in the range 4 through 253, the PDL functioa returns a rather 
unpredictable nupbcr fropi to 255<, and laay cause various side effects , some 
of which may dlF>turb prngfam ejiecutlon- 

FoT instance. If \aoKpr\ is In the tange 204 to 2]9, uae of the PDL function 
Is frequently and rather randonly accompanied by a "click" from the 
conpucer'a speakeri 



If N 18 In Che range 236 through 239, FDL (N) may result In a 

POKE -Ift^AH+H, i 

so that FDI,(236) rasy set CRaphics mode. PDL(2371 can set TEXT mode, etc (see 

Appendix J), 

In addition to reading the settinKS of 4 variable game controls using PDL| 
APPLESOFT can read the state of 3 game buttons {on-off switches) uSinjj 
various PEEK commands, and can turn on and off i Eflme read-outs (TTL 
svitchca) using various 1*CIKE commands (sue Appendix ■])- 
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HOW TO CREATE A SHAPE TABLE 



APPLESOFT has five special commands which allow you to manipulate shapcH In 
hlgti-rtsolution graphics: DRAH» XDRAW, ROT> SCALE, and SHLOAD. Before thfmf 
APPLESOFT CDBimaails can he used, a shape must be deElTied by a "shape 
definition." This shape definltlo^n consists of a settucncc of ploctilng 
vectors chat are stored in a series of byces in APPLE'S nenary^ One or more 
such shape definitions, with their index, make up a "shape table" that (.-in 
be c^reated from the kcyboaird and saved on disk or cassette tape for lutiirp 
u&e- 

Eacti byte In a shape definition le dlvldtd into three sections, and each 
section tan Hpeclfy 3 "plotting vector": whether or not to plot a point* atMi 
also a direction to move (up, down, left, or right)- DRAW ^nd XDRAH step 
thriKiEh each byte in the shape definition Section by section, froin the 
definition's first byte through its last byte. When a byte that containa 
all zeros is reached, the shape definition Is complete. 

This is how the three sections A, B and C Are *rcanged mJ thin one of the 
bytes that make up a sbape dcfinlclonE 

Sect ion t C B A 



7 6 5 4 J 3 1 



Bit Number: 
Specifies: D D P D D P D 



Each bit pair BD specifies a directlOiV to move, and each bit F specifies 
whether or not to plot a point before moving, as follows: 



If DD - 99 move up 

■ 0t iBove right 

> 10 move down 

- II Bove left 



If F - don't plot 
- 1 do plot 



Notice that the last section, C (the tuo aogc significant bitB>, does not 
have B P field (by default. P-fl), bo section C can only specify a move 
without plotting. 

Each byte can represent up to three platting vectors* one ID section A, one 
In section B, and a third <a move only) In section C. 

DRAW and XDRAU process the Sections from right to left (least significant 
bit to Di^st Significant bit: section A,, then B, then C). Ac any section in 
the byte* IF ALL THE REMAINING SECTIONS OF THF. BYTE COMTAIK ONLY ZES03, THSN 
THOSE SECTIOMS ARE IGNORED. Thus, the byte cannot end with a nove in 
section C of 9^ (a move up, without plotting) because that section* 
containing only zeros, will be ignored. Similarly, if section C ia 9<t 
(ignored), then section S cannot be a move of 999 as that will also be 
ignored. And a nove of 000 in section A will end your shape definition 
unless there is a l~blt someHhere In section B or C. 




Suppose you want to draw a shape lik^ this: 



First, drau it on graph paper, one 
dot per square. Then decide where 
to Htart drawing the shape ■ Let's 
Ht4^rt this one at the center. Next, 
draw a path through each point in 
the shape, using only 30 degree 
angles on the tutris: 




Next, re-dtBW the gh*pe as a aeries 
of plotting vectors, each one moving 
one place tip, down, right, or left, 
and distinguish the veotots thst 
plot a pcit-nt bcEore oioUing; ^a dot 
marks vectors that plot polsits)- 



Mow "unwrap" those vectors and write them In M straight line: 

M — ■ tin • — nn — - 

Next draw a table like the one In Figure I,, below: 



Section C 


B 


A 




C 


B 


A 


Byte 






i 






010 
111 


010 
111 






1 


1 






100 


[100 




— 


i 


I 




91 


100 


100 






*-■ 


•*- 






101 


101 






* 


*— 






0]0 


10t 






1 


1 






110 


tl0 






*- 


1 






011 


110 


8 






*• 








LU 


9 










00 


V0» 


100 



Vector 


Code 


t 


m 




001 or 9i 


i 


»10 or 10 


— 


011 OT U 


t 


t00 


•*■ 


101 


I 


110 


■•* 


111 



iKove 
(Only 



Plot 

6. Move 



-This Vector ^ 
Cannot Plot 
or Move Up 



'Denotes End 
of Shape 
Qeflnitlon 



Figure 1 



For each vector in the line, determine the bit code and place It in the next 
.ziujiUnblo aec^tlon in the tahLi^. If The code will not fit {for example, the 
vL-irtor in acirtion C can't plot a point}, or is a 00 (or ■008) at the end of a 
byte, then skip that section and go on to the next. When you have finished 
coding all your vectors, check your work to make aure it fs accurate. 



^ 
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Hou make anoCher cable, as shown In Figurie 2, below, and re-copy thu vector 
codes f torn the first table. Recede the vector InforEnaClon into a acrlea oF 
hexadecimal bytes, using Che hexadccinaL codes froa Figure 3« 

















Bytes 






Co 


des 


Section 


: C 


B 




A 






Recoded 

In Hex 

I 2 






Binary 

9999 


Hex 


Byte 9 


V 9 9 


1 


« 9 


1 


9 


- 


1 


9 9 I 


1 


1 I 


1 


I 


E. 


3 F 






0001 


• 1 


2 


9 9 1 


9 


9 9 


9 





> 


2 9 






0010 


- 2 


3 


tf L 1 


9 


* I 


9 


9 


>» 


6 4 






00L1 


- 3 


it 


tf 1 


9 


1 1 


9 


L 


- 


2 D 






0100 


- i* 


5 


9 9 


1 


1 


9 


I 


- 


I 5 






010£ 


- 5 


t 


4 4 1 


1 


d L 


I 


If 


■= 


3 6 






0114 


« 6 


7 


{» 9 


1 


1 I 


1 


9 


- 


1 E 






0in 


- 7 


8 


9 i fi 





9 1 


1 


I 


- 


9 7 






1000 


- S 


9 


9 9 9 





9 9 


» 


a 


= 


fl ♦-Denotes End 


1001 
1010 


•> 9 
■> A 




■ 




■ 














Hex: 


DiglC 


1 


Dig 
Pitt* 


t 
in 


2 
» 2 






Deli 


n 1 c t on 


10tL 
1100 
U«l 
1110 
ilEl 


- B 

- C 

- D 

. E 

- F 



Figure 3 



The series of hexadecliDal bytes Chat you arrived at in Figure 2 la the shape 
definition. There is sclll a llctls more Infcrmdtlo'n yau need ca provide 
before you have a complete shape tables The fotm of the shape table^ 
complete with lt6 Inde^r ^b shown Iti Figure 4 on the next page. 

For this cicaniplc, your index is easy: there is only one shape definition. 
The shape cable's acarclng location, whose address we have called S, must 
canCain the number of shape definitions fbecueen snd 255) In licxadecttiu?l> 
In this case, that number is Just one. We will place our shape definition 
ifnnedlately below the index, for simplicicy- That meaas, in ChJs case^ the 
shape definition tiill start In byte &+4; the address of Shape de£inlC10i) II, 
relative to S, la fi (00 04, in heKsdecimal)- Therefocet Index byte S+2 must 
contalf^ the value 0^ ^nd indox byt<^ £'^3 must contain the value 00. The 
completed shape table for this example la shown in Figure 5 on the next 
page. 



t: 






Sturi-S 



I tldCK 



3 



Byte S+9 


n (0 CO Ff) 


+1 


Unused 


+2 


Lower 2 Digits 


+3 


Upper 2 Digits 


+4 


Lower 2 Digits 


+5 


Upper 2 Digits 


• 


- • * 


+2n 


Lower 2 Digits 


+2n+l 


Upper 2 Diglia 



fii-f Imicions 



-Total Number of 

Shape DeUnitione 

Dl: Index to First Syte of Shape 
Definition #1, Relative to S 

□ 2: Irtdex to First Byte of Shape 
Definition *2, Relative co S 



Dn; Index to First Byte of Shape 
Definition ta, Kelatlve to S 



S-K)l 


First Byte 


, 


- 


. 


Last Byte-00 






S^2 


First Byte 


, 


. 


, 


Lasc 6vce-00 


• 


* 


S+Bo 


First Byt& 


^ 


. 


. 


],a&E Byte -00 



Shape Definition 01 



Shape Definition #2 



Shape Definition In 



Figure 4 



I- 



{= S 



lEr 



Start 


Byte 





0t 


1 Kiimber of Shapes 


fStore aiddress 




1 


00 




111 KS and E9) 




2 


0^ 


Index to Shape Definition fit 






3 


00 


Relative to Start 






I, 


12 


■•-First Byte 






5 


3F 








6 


29 








7 


6C, 








8 


2D 


Shape Definition #1 






9 


15 








A 


36 








B 


IE 








C 


07 








D 


00 


«-Laet Byte 
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Figure 5 
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Yoy are nou ready to type the shape table into APPLE'S tnetnory. FlE&tt 
choose a starting address. For this example, we'll use hexadecimal addreaa 
IDPC. (NgCet this address muBC be less than the highest memary address 
available in your system, and not in an area that will be cleared when you 
use HGR of HGR2. location IDFC ia just below the high-resolution graphics 
page L, used by HCr. ) Press the BESET key to enter the Monitor program, and 
type the Starting address for your shiape table: 

tDFC 
if you press the RETURN ]cey ngw, APPLE uill shou you the address SAd the 
cqn.t.eritg of that address. That la hou you eitatolne an addreaa Co see If 
you have a puc the correct number there. If instead you type a colon C t ) 
followed hy a two-digit heKadcciinal flunber, that number will be stored at 
the specified address when you press the RETURN key. try this: 

IDFC return 
What does APPLE say the contents of location IDFC are? Nov try thlS! 

1DFC;01 rectirri 

IDFC return 
IDFC- 91 

The APPLE now ssys that the value 01 (bexadeclmat ) Is scored in Che location 
whose address Is IDFC. To store more two-digit hexadecimal numbers In 
successive bytes in memory. Just open the first address: 

IDFCt 
and then type the numbers, separated by spaces:: 

LDFC:01 99 94 00 12 JF 20 bi. 2D 13 36 IE 07 99 return 

You have just typed In your first complcCe shape table.r.noC SO bad, was icT 
To check the Information In your shape cable, you can examine each byte 
separacely or siatply press the KETtFRK key repeatedly until all the bytes of 
inceresc (and a few extra, probably} have been displayed: 

IDFC recurn 
IDFC- 0i 

* return 
00 04 00 

* return 

1E00- ]2 3F 20 bit 2D 15 36 IE 

* return 

lESB- 07 00 DF lb 23 00 00 FF 

If your shape table looks correct, all that remains le to score the scarclng 
address of the shape table where APPLESOFT can find ic (this Is done 
auconacical 1y when you use SHLDAD to get a table from csasette tape). 
APPLESOFT looks for the four hex dlgica of the cabie'a starting address in 
hex locations ES (lower cwo digits) and E9 (upper two digits). For our 
table's starting address of ID FC, this would do Che Crick; 

E8:FC 10 return 

To protect your shape table from being accJdencaHy erased by your APPLESOFT 
program, It might also be a good idea to sat UIHEH: {in hex locations 73 and 
74) Co Che table's starting address: 

73: FC ID 

This too is done automatiically when you use SHLOAQ to get the tabls from 
casBetce tap'e< 
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SAVING A SHAPE TABLE 



To save your shape table on cape, you need Co knew three things: 
1) Starclng address of the cable [IDFC, in our example) 
2} Lasc address of the cable (1E09, in our example) 
3} Difference between 2) and 1> (000D, In our example) 

Iteo 3, the difference between the last address find the first address of the 

cablSi ntist be stored in hex locations (lower two digits ) and 1 (upper two 

digits): 

iilla 00 return 

Kow you can "Write" <Btore on cassette) first the table length chat is 
atored in locations to 1, and then the shape cable itself that is stored 
in locacloQs SCarClng Address through Last Address: 

0. lU IDFC.lEOgU 

Don't press the RETURN key until you have pot a caSscCCe in your Cape 
recorder, rewound it, and started it recording (press PLAlf and RECORD 
slnulcaneously). Now press the computer's KETIRK key. 

To use the tape, rewind it, start ic playing {press PLAf), and (In 
APPLESOFT^ now) type 

SHLOAD return 

You should hear one "beep" when the table's length hag been read 
successfully, and another "beep" when the cable Itself has been read- 



USIN0 A SHAPE TABLE 



You are now ready to write an APPLKSOFT program using the shape-table 
commands DRAW, XDRAU, ROT and SCALE. 

Here's a sample APPLESOFT program that will print our defined shape, rotate 
it 16 degrees, and Chen rcpeac, each repetition larger than the one before* 

10 HGR 

20 HCOLOR - 3 

30 FOR R - 1 TO 5i» 

40 ROT - R 

i0 SCALE - R 

b\» DRAU I AT 139, 79 

70 UEXT R 

To sec a Single "square", add a line 

k'i END 

Til pause and chen erase each square after It is drawn add these lines: 

b3 FOK 1-0 TO 1000: KEia 1 

&^ XDHAW 1 AT 139» 79 
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DRAU a^xprl AT aexpr2, aexpr3 
DRAH aexprl 

DRAW with tlfie first option draws ^ alhepe In hlgh-reaolutloti graphica 
starting ac Che point wliose x-coordlnace U \9expr2\ and whose y-coordlnati' 
Is \ae)(pr3\. The shape dtawn Is the \aexprl\th shape deflnicion In the 
shape table previously loaded using the SHLOaD conraaTid (or a ahap« tohli^ mjiy 
be typed into the APPLE'S memory In henadedmal code, yslng the Hooitor 
program) ■ 

\aeKprU must be in the range ^ through n, where n la the number tfcofa 
through 255) of shape definitions given in byte of the shape tabic. 
\aexpr2\ must be In the range through 276. \aexprJ\ in the range 9 
through 19U If any oE these ranges Is exceeded, the message 
711LECAL QUANTITY ERROR 
will be dlEplajied. 

The color, rotatiop and scale of the shape to he draim must have been 
specified before DRAU 1b executed. 

The second option is Hlmn4f to the first, but draws the apeelfied shape 
starting at Che Sast point plotted by the Bost recently executed HPLOT, 
DRAU, or XDRAU conraand. 



® 



IE isstied when there is no shape table in the compucer, may cause the systGrn 
to "hang." To recover, use reset ctrl C return. May als& draw random 
"shapes" all over the high-ireaolution graphics areas o£ memory, possibly 
destroying your program, even IE you are not In graphics mode. 



XDBAW Imd & dcf 

XDBAW aejcprl [AT aejtprZ, aexpr3] 

This coiBBiand is the 8aee as DRAW^ except t^iat the color used ta drau the 
shape la the complement of the color already existing at each point 
plotted. These pairs a£ colors are compleoientH! 

ViacV. and White 

ILlue and Green 

The purpose o£ XDRAW 1b to provide an easy way to erase: If you JfflRAy a 
shape, and then XDRAW it egain, you'll erase Clie shape without erasing the 
backg.round'i 

See cautionary cemarks for DRAW. 
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KCrr Iran f. Act 

ROT - acKpr 

SetP Angular rotation for shape to be drawn by DRAW or XDRAH. The aratmot i^f 
rotation Is specified by Vaexpr V^ which must be between to Z35. 

KaT-0 win cause Che shape to be DRAWn oriented Just as It was defined, 
KOT-16 will cause the shape to be QSAUn rotated 94 degrees clockwise, ROT-32 
will cause the shape t» be DBAWji rotated ISfl degrees clockwise, etc. The 
process repeats starting at EtOT'bA. For SCALE'l, only A rotation values are 
recognised (9, l^, 32,48) ; for SCALE-2, S rotations are recognized, etc. 
Unrecognised rotation values will cause the shape co be DRAWn with the 
iirientation of the next smaller (usually) recognised rotacloa- 

KOT parses as a reserved word only if tiie next non-apsce character Is the 
rcplacecoent sign C « 1> 



SCALE iiirm & def 

$CALE - aexpr 

Sets scale size for shape to be drawn by DRAW or XQKAU to factor from 1 
(point for point reproduction of the shape definition} to 233 (each vector 
extended 233 times) as specified by Uexpr\. NOT£: SCALE-Q Is maxlmiin 
aire and not a single point. 

SCALE parses as a reserved word only If the next ^on-space character is the 
ceplacenent sign { « K 



i.mX}M> ima & def 

SKU»AD 

Loads a shape table from cassette tape . Shape table is loaded Just beloW' 
H1HEM: and HIMEN: Is set to Just bclov the shape table to protect It. The 
shape table's starting address Is given to APPLESOFT'S shape-drawing 
routines automatically. If s second shape table is loaded, replacing the 
first table, HIHEH: should be reset prior to loading to avoid wasting 
memory. Shape tahle tapee are prepared u^ing the inst rue t Ions at the 
beginning of this chapter* 

On IbK syatemst HGR clears the top SK of ciemory, from location S192 to 
location 163&3. To force SHLOaD to put the shape table below page 1 of 
hi^h-resolution graphics, set Hl}im:&i92 before executing SHLOAD^ On 24K 
aystens, do not use HCSi.2 (which clears nenory fcon location 16384 to 



w 



location 24575), or else set HIMEHj 1638^ before SHLOAD and do cipC use HGR. 
If you ate sure there is enough safe tnetnory above location 2^575 to hold 
your shape table* there is nothing to worry about- 
Only reset can interrupt SHLOAD. If the reserved Word SHLOAD begins d 
varlablff naicfi, the reserved-vord command may be executed before any 
?S.YNTAX ERROR Is given. The Statement 
SHLOADER - 59 

hangs Che systeia, vhlle APPLESOFT waits Indefinitely for a pco^ram from the 
cassette recorder. Use reset cCrl C to regain conctDl of the cuiapLitGr' 






SOME MATH FUNCTIONS 



102 The built-in funcclons SIH, COS, tAN, 

ATn, IHT, ftllD, SCS, ABS, SQR. EXP, LOG 
J03 derived Functions 
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BUILT-IN FUNCTIONS 

All functions may be used wherever 9vt eKpresslon of the Bame type may b* 
used- They may be used in either liwnedlace or deferred eKecuCion, Here are 
brief deaerlpclons at some o£ APPLESOFT'S arithmetic functions. Other 
functions are described in sections dealing with similar inBtfuctiona-i 




Haimea a (CO 6 places, e-2- 718239) to the indicated power, \aexpr\* 
KcCUTtiB the natural logaEithm of Wexpi\. 



Eeturos the sine of \aexpr\ tadiaae- 

COS (apxpr^ 

Returns the cosine of \aeiipT\ radians* 

TAN (.-11. xf.!- h 

Returns the tangent of \aeicpr\ radians. 

Air; f..r-.Li-.r'' 

Returns the arctangent, io radians, of Vaexpr\< The angle returned is irt 
the range -pi/2 through +^1/2 radians. 

I', i" [-1. --.pr I 

Returns the largest integer less Chan or equal to VaeKprX* 

Returns a random real number gfeaCeC than or equal to t and less than I. 

If \aexpr\ is greater than zero, KHD(acxpr) generates a new random number 
each cime it la used^ 



t£ VsexprV is less cTiaii aero, RNQiaexpr) generates t 
each tine it is used with the same \acj(pr\, as if fr 
nu&ber cable built Into the APPL-E- If a particular 
used to generate a rondom number ^ then aubseqiienc ra 
«ith positive acEtimenta will Sol\o« the same aequenc 
different random sequence is initialized by each diE 
argijisent> The primary reason for using, a negative a 
tnittalize <or "seed") a repca table sequence of rand 
particularly helpful In debugging programs that use 



he eame tsndom number 
on a permanent random 
negative argument is 
ndom nunbers generated 

ea'Ch time- A 
ferent negative 
rgtiinent for RNO is to 
om numbers. This is 
RHD. 



If \aexpr\ Is 2eto, RHD(aG>:pr) returns the noat recent previous random 
nyiaber generated (CLEAR afid NEW do not affect this). SometlKPS this is 
easier than assigning the last randaa number to a variable in order to save 

it. 

SG?i ((icxpr> 

BeCUTltB -1 if Uexpr\<g, returns if XaexprV*!!, and returns 1 if \aexpr\>(l. 

Returns the absolute value of \aexpr\ ie. \aeKpr\ If \aexpr\?»fl, and 
-\acxpr\ if \aexpr\<(l. 






Returns the positive square root- 
executes more quickly than ^i 3 



This is a special ImplemenCatlon that 



DERIVED FUNCTIONS 



Tlie following functions, while not intrinsic t*> APPLESOFT BASIC, can be 
calculated using the existing BASIC functioos and can be easily iinplemenCed 
by using the D£F FN function. 



SECAHT; 

SEC(X) - 1/C0S(X) 



COSECANTj 

CSCU) - i/SIN(X) 



COTANGENT! 
C0T(X3 - I/TANtX) 



INVERSE SINE: 

AECSIH(X> - ATB(K/SqR t-X*X+n> 



INVERSE COSINES 

AftCCOS(X) - -ATN<X/S<JR(-X*X+1>)+1,5JW 



INVERSE SECANT: 

ARCSeC(X) - AtN(S(^(X*X-l))+CSGN(X)-l)*l.57(aa 



INVERSE COSECANT: 

ARCCSC(X) - ATN(l/5qB(X*X-n)+(SG«(X)-l)*l.S?(l8 



INVERSE COTANGENT: 
ARCCOT(X) - -AT!l(X)+!,57fl8 



HYPERBOLIC SINE: 

SIN1I<X) * <EXP(X)-EXP(-X))/2 
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HYPERBOLIC COSINE: 

COSH(X) - CEXPlXl+EX?{-K))/2 



HYPERBOLIC TANGENT: 

TAHH(X) - -EXP[-X>/(EXPiX)+EXP("K))'<2+l 



HYPERBOLIC SECANt: 

SECH(X) - Z/(E}U'(X)+EXP(-S}) 



HYPERBOLIC COSECAJJT: 
CSCH<X) - 2/[EXP(X>-E)lP(-X>) 



HYPERBOLIC COTANGENT! 

COTH(K) - i:XP(-XW{EXPtX)-EXP(-X>l*2-H 



INVERSE HYPERBOLIC SINE; 
ARGSINH[X) - L0C(X4SQR(X*X*t)> 



INVERSE HYPERBOLTG CDSINE: 
ARGC05H(X) - LOG(X+StJRCX*X-l>) 



1HVi£SE HYPQIBOLIC TABGENTi 
ARCTAHH(X) - LOG< (1+X) /(l-XD/Z 



IHVtSSE HYPERBOLIC SECAWT: 
ARGSECH(X) - LOG((SQR(-X*X+l)+n/X 
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APPENDICES 



Getting APPLESOFT BASIC up 

Prograis Editlne 

Error KeeaageB 

Spflc« Savers 

Speeding Up Your Progran 

Decimal Tokens for Keywords 

Reserved Words in APPLESOFT 

Converting BASIC Proarams to APPLESOFT 

HeiBory MjBp (sec also page i37) 

PEEKa. POKES and CALLs 

ASCII Character Codei 

APPLESOFT Zero Page Usage 

DifEcrencce Between APPLESOFT and tnteger bA&IC 

Alphabetic Glossary of Syntactic Deflfiitlana 

and Abbreviations 

Summary <si APPLESOFT Cammanda 



INVERSE HYPERBOLIC COSECANT: 

ARGCSCH(X} - LOG(SGH<X)*SQB(K*X+l>+l)/K 



INVERSE BYPEHBOLIC COTANGENT: 
ARGCOTH(X> - L0C<{X+l>/(X-l))/2 
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A HOD B 

HOD{A) • 1NT((A/B-INT£A/B))*B+.(IS>*SCN(A/B) 
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Appendix A: Getting APPLESOFT SASIC Up 
And Running 

APPLE Compucer Inc. offers Cwo vetsiona of the BASIC programming langyage. 
Integer BASIC, described in che APPLE II BASIC ProRraimnlnR Manual , ie a 
very fast BASIC suited for many applications, especially in education, game 
playing, and graphics. The other version of BASIC is called "APPLESOFt" and 
Is Ijeccec suited for naat business and scientific applications. 

AFPI.ES0F1 BASIC la available In two versions. Firmware APPLESOFT cotdss with 
APPLESOFT in BOW on a printed circuit card (AP^LE Part Mumbef AaBBfldSX) 
which pliiifl directly Into the APPLTi 11. WlCti this option, the flick of a 
switch and two key-strokes start the APPLE II running In APPLESOFT. Aside 
from this convenience, havlnK APPLESOFT in ROM saves abouC IflK of neniary and 
saves much time loading the language in at every use, from a cassette tapC'. 
The main body dE this manual assumes you have the flrffware APPLESOFT card. 
If you are using Che cassette version of APPLESOFT, see PART II £i_ 
this appendix for special instructions aiid n&tes on where your APPLESOFT 
differs from that described in the rest of ihla manual* 

Hote; In cHia fflanual, the word reset means to pfes6 the Icey marked HESET, 
retifrn means to press the key marked RETUKM, and Ctrl B raeans to type B 
ublle holding dovn the Key marked CTRL . 

AH IMPQRTAKT KOTE : 

One of the Eunctlofls of the prompt characCert besides PROHPTlng you for 
input to the compucer, is to identify at a glance «hich language the 
computer is programnied Co respond to 8t that time. For Inacance, up till 
Dov you have seen two prompt characceta: 

* for Che Monitor program (when you press RESET) 

> lor APPLE tnteaec BASIC <che noraal integer BASIC) 

Uow we introduce a third prompt character; 

I for APPLESOFT floating-point BASIC. 

By simply looking at ihia prompc character, you can easily tell (If you 
forget) which language Che computer is In. 

PART 1: FIRMWARE APPLESOFT 

INSTALLING THE FIRMWARE APPLESOFT &OAKD 

The flrnwarfi APPLESOFT card simply plugs Into a socket inside Che APPLE II. 
Care must be exercised, however, so follow these iflstructlons exactly: 

1) Turn the APPLE oEfs very lnqsoreant to prevent damagina the computer- 

2) KeDDVe the cover from the APPLE II. This is done by pulling up on Che 
cover at the rear edge <thc edge farthest from the keyboard) until the two 
corner fasteners pop apart. Do noC continue to life the rear edgs, but 
Bllde the cover backward until it comes free. 
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3) Inside the APPLE II, across che rear of the circuit boardj there ±s a 
ro« of ei^ht long, narrow sockets called "slots." The leftmost one (looking 
at the computer from the keyboard end) is slot ^0; the rightmost one is slot 
17. Hold che APPLESOFT card so that its switch Is toward the back of the 
coriputer; insert Che "fingers" portion of the CSr4 Into the leftmost aloe, 
slot 19, The Einger? will enter the alot ulch some friction, and will then 
seat firiQly. The APPLESOFT cacd must be placed in alot SB. 

4) The switch on the bacfc of the APPLESOFT card should protrude part way 
through che slot on the baclt of the APPLE 11. 

5) Replace the APPLE'S covert first slide the front edge Into place, Chen 
press down on che two rear corners until they pop into place. 

7) Now turn on the APPLE II, 



USING THE FIRMWARE APPLESOFT BOARD 

Ulth the APPLESOFT card's switch In the downward posicion, the APPLE It 
will begin operating in Integer BASIC when you use reaet Ctrl B (this 
manual's way of saying; press the key roerfced RESET, then hold down the key 
marked CTRL while typing B>. You will see the prompt character >, which 
indicates Integer BASIC. 

With the switch in the upward position* reset ctrl B will being up 
APPLESOFT BASIC, instoad of Integer BASIC. The proiqit character ] cells you 
you're in APPLESOFT, 

When using the Disk Operating System, the computer will aucosiBtically choose 
Integer BASIC or APPLESOFT, as requited. It does not matter in which 
position the switch is set. 

You can also change from Integer BASIC to APPLESOFT, or vice versa, 
with out operating the switch on che firmware card' To put the computer 
into APPLESOFT, use 

reset C080 return 
Ctrl B return 

and to put the compucer into Integer BASIC, use 

reset cflfiL rctwrn. 
Ctrl S return 



AJJOTHER IMPORTANT HQTE ; 

Sometime you may accidently hiC RESET and find yourself in che MoniCor, as 

shown by che * prompc character. 'You may be able to return lo APPLESOFT 

BASIC, with APPLESOFT and your program intact, by typing 

Ctrl C return 
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PART 2: CASSCTTE TAPE APPLESOFT 



APPLESOFT II BASIC Is provided on cassette tape, at no charge, with each 
APPLE II. APPLESOFT BASIC loaded from cassette tape occupies approximately 
l^K bytes of meiDory, thus a coicpucgr with L&K bytes or more memory Is 
renutred to use the caasgcte version of APPLESOFT BASIC . 

GEITIBG STARTED HITH CASSETTE TAPE APPLESOFT 

Use the folLoulng procedure to load APPLESOFT frora your cassette unit: 

1) scare up Xnte^ct BASIC by typing reset Ctrl B. If you are unfamiliar 
with this procedure, see your APPLE Integer BASIC Programmltig Manual. You 
will know you are in Integer BASIC uhen you see th^ prompt {character > 
displayed on the TV screeri, followed by the blinking square "curaor*" 

2) Place the APPLESOFT tape (Part Number A2T(i904> In your cesaette recorder 
and rewind the tape to the beginning. 

3) Type LOAD 

it) Press the recorder's "play** lever to start Che c^pe playing' 

5) Press the key marked RETUKN on the APPLE II keyboard. When you do this 
tlie blinking cursor will disappear. After 5 to 20 seconds the APPLE II Mill 
beep, to signal that the tape's Information has started to go Into ttie 
computer. After about 1-1/2 mlnutesT chere will be another beep and the 
prompt character > follt^wed by a cureor will reappear. 
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6) Stop the tape recorder and rewind the tape, 
computer I 



APPLESOFT la ntiu in the 



7> Type RUN ai^d preSS ttie key marked RETUSN. The screen will display the 
copyright notice for APPLESOFT II and APPLESOFT'S prompt character, J - 

Sometime you may SCCldentatly hit the RESET key and Eind yourself in the 
Mortltor program, as shown by the prompt chfiractsr * • You may be able to 
return to APPLESOFT, with your pEOgrao 3n,d APPLESOFT Itself still Intact, by 
typing 

■BC return 

IE this does not work^ you will Have to re-load APPLESOFT from ca&setCe 
tape. 

Typing Ctrl C or Ctrl B from Che Monitor proaram will trsRHfer you to APPLE 
Integer BASIC; this will erase APPLESOFT* 

Ifi this manyal, reset means to press the key marked BESET, return means to 
preas the key marked RETURN, and Ctrl B means to type 3 while holding down 
the key marked CTKL .. 
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DIFFERENCES BETWEEN FIRMWARE APPLESOFT AND CASSETTE APPLESOFT 



APPLESOFT on cassette tape (Part Number A2Ttl0tl4) does not work exactly the 
same as does the firmware version of APPLESOFT that resides In R0^! oo a 
plug-Jn printed circuit card (Part Number A2B0()09X). Moat oE this manual 
describes the flSTKuare version of APPLESOFT. The following camiQentB point 
out how casaetEe APPLESOFT differs from firnHare APPLESOFT. 

Because cassette APPLESOFT occupies approximately IflK ijf memory (and the 
computer uses another 2KK cassette APPLESOFT cannot be used ItI APPLEa with 
less than L6K of memory. With cassette APPLESOFT loaded, the lowest memory 
location available to the user Is approximately 1Z3M. Firmware APPLESOFT 
does not reside in RAH tnemory, so it can be used (without hlgh-reeoJ-Ution 
graphics) In smaller systems* 
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UGR 1b not available in cassette APPLESOFT. The HCR command clears "pa,se 
I" of graphics memory {BK to 16K) for high-reaolutlon graphics. Since 
cassette APPLESOFT partly occupies this portion of memory, atteirpting to use 
HCR will erase APPLESOFT, and may erase youf progrsm. The b3CR2 command can 
he used both In the ROM and in Che cassette versions of APPLESOFT, but is 
only available if your APPLE contains at least 2AK o£ tneinory. Therefore, In 
a aystem with less than 2.UK of memory, cassette APPLESOFT does Tiot offer 
high*resolut Ion graphics- 

The ctrmmand 

POKE -]&30t,e 

converts any full— screen graphics n»de to mixed graphics— pins— text mode* 

When issued after HGg3, however, the four lines of text are taken from pane 

2 of text memory. In the cassette version of APPLESOFT, APPLESOFT Itself 

occupies page 2 of text memory, so that mixed high-resolution 

graphica-plua-text Is not available. 

With Integer &AS1C, and with APPLESOFT on the firmware card, you can return 
to your program after en accidental or intentional press of the RESET key by 
using Ctrl C return. To accorapllsh the Same thing with cassette APPLESOFT, 
yon must use IK return (type 9, then lype C and press the RETURN key). If 
you ate uaing cassette APPLESOFT, reset Ctrl C return will reinstate Integer 
BASIC as your programming language; this will erase APPLESOFT. 

In short, everywhere thl8 manual says to use 

reset Ctrl C return 
cassette APPLESOFT users should use 

reset 0C return 
Instead. 



Where the manual sayS to uSe 

reset Ctrl B return 
you can do the same, but you will then have to reload APPLESOFT froir 



tape. 
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In cassette APPLESOFT, use CALL 11246 {Instead of CALL 62430) to clear the 

HCR2 screen to black. Use CALL 11250 (instead of CALL 6245'!) to clear the 

HGR2 screen to the HCOLOR Last HPLOTted- if executed before you issue the 
MGK2 command the first time, these CALLs may erase APPLESOFT^ 
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Appendix B: Program Editing 



Host ordinary hvimans make mistakes occasLonally. i.cBpecially when urlCiTig 
compucer progracLSi To EaciliLate correcClRg these "oversights" APPLB lias 
Incorporated S uril«|ii? sec of ^dicing f&acures Inco APPLESOFT BAStC. 

To toake use a£ them you will first need to famlllaElxe yourselE with the 
functions oi Eour special keys on the APPLB H keyboard- They are the 
escape key, marked ESC, the repeat key^ iostk«d REFT, and Che lefC- and 
rtght-arrow keys, which are narked with a left arrow and a right arrow. 



ESC 

The esf^ape key ( ESC ) 1b the leEtmost key in the Second row Erocn the top. 
It ia ALWAYS used with anochei: key (such as A, B. C or D kcya) in chia 
way: push and release ESC, and theii. push and release A, ioc 
insCance . . . . alcertifltelv * 

This operation or sequence of the ESC key and then another key is written as 
"escape A". There are four escape functions used for editing: 

escape A noves cursor to the right 

escape B noves cursor to the left 

escape C raoves cursor down 

escape D moves cursor vp 

Using the escape key and the desired key, the cursor may be moved to any 
location on the screen without affecting anything chat is already displayed 
there, and without affecting anything in meinory. 



KIGST-ASROW KEY 

The right-arrow key moves Che cursor to the right. It Is the most 
time-«avln^ key on the keyboard because it not only moves the curaoTr but IT 
COPIES ALL CHARACTERS AND SYMBOLS IT "HOVES ACROSS" INTO APPLE 11 *S MEMORY, 
JUST AS IF YOU HAD TYPED THEM IN FROM THE KEYBOARD YOURSELF. The TV dlBplay 
jia not changed when you use ttie righc-srrow key. 



LErr-ARROU KEV 

The lefc-arrou key eioves the cursor to the left- Each time the cursor moves 

to the left, ONE CKARACTEEt IS ERASED FROM THE PROGRAM LINE WHICH YOU ARE 
CURRENTLY TYPING, regardless of what the cursor is moving over. The TV 
display Is not changed when you nee the left-arrow key. Usually the 
lefc-arrow key (^annat be used to aove the cursor Into the lefcmosc coiumni 
u6e escape B to do this. 
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TIEPT 

The REPT key la used with another character key on the keyboard- It causes 
a character to be repeated as long as both the character's key and the REPT 
key are held dflun. 

Now you're ready to use these editing functions to save time when making 
changea or corrections to your prfigrata. Here are a few examples of how to 
use them. 



Example I — Fixlna Typoa 

Suppose you've entered a program by typing It in, and when you RUM It, Che 
computer prints SYNTAX EftR and stops, presenting you with the ] prompt and 
The flashing cursor. 

Enter Che folliawtng program and RUN ll. Note that "PKIHT" and "l*RECRAH" are 
mis-spelled on purpose. Below is approximately liow it will look on yOur TV 
display: 

110 PRIKT "THIS IS A PSEGRAM" 

120 GOTO 10 

]RIIN 

?SYNTAX EBR IN IB 

Now type the word LIST and press return: 

I LIST 

10 PalMT"THlS IS A PKEGRAH" 
29 GOTO 10 



To move the cursor up to the beginning of line !fl, type QKcapc D three times 
and then escape B> Mote: It is important to uSe escape B to place the 
cursor over the very FlrPt digit In the line number. The TV screen will 
now Look like cbia: 

{LIST 

■fl PRIHT'THIS IS A PREGRAM^' 
2(1 COTO 19 
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Now press the rlghc-acrow key 6 times Co raawc Ehe curaor on to the letter H 
in "PRLMT". Remembert as Lhe right-arrow key moves the cursor over a 
character o-n the screen,, that character is copied into APPLE 's nieniory JU8C 
as If you had typed it in from the keyboard. The TV display will now look 
like chifi: 

)LIST 

10 PRItT"THIS IS A PRECKAM" 
2(1 GOTO l|f 

] 

How type the letter N to correcc the spelling of "fRIMT", then copy (uaing 
the right-arrow key and the repeat key) over to the letter E ia "PRECRAH"* 
The TV screen will now look like this; 

ILIST 

Id PRIHT"THIE IS A PRKRAM" 
20 CPTO )0 

1 

If you typed the right-arrow key coo many times by holding down the repeat 
key too l»ng, use the left-prtow key to baclcspace back to the letter E- 
Now, type the letter t<t COXt^t^t "PREGaAH" and copy using the right-urrow 
key to the end of line 1(1. Finally, atore the nsW line in program memory by 
pressing the RETURN key. 

Type T-IST to see your corrected program: 

jLIST 

1 

10 PRINT "THIS IS A FROCRAH" 

20 GOTO 10 

n 

Nov RUN Che prograca (use Ctrl C to atop the program): 
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THIS 


IS A PROGRAM 


THIS 


15 A PROGRAM 


THIS 


IS A PROGRAM 


THIS 


IS A PROGRAM 


THIS 


rS A PB0CP.M1 


THIS 


IE A PROGRAM 


THIS 


IS A PROGRAM 


THIS 


IS A PROGRAM 


BREAK IN 10 
11 






Kjtample 2 — Inserting Text Into an Existing Line 

In the previous ej^ampJe. syppoBe you had wanted to insert a TAB(10) command 
after the PRINT In line 10. Hece's how you could do it. First LIST the 
line to be changed: 

]LtST 10 

i9 raim "THIS IS A FJtOGRAH" 



Type escape D'& and an e&cape B until the cursor is on the very first 
clmracter of the line to be changed; then use the right-arrow and repeat 
keys CO copy over to the first quocation mark- (Remerabef, a character Is 
not copied into aemory until you use the rlght-acrow key Co move the cursor 
iron chat character on to the next.) Your TV display should now look like 
this; 

]LIST 1? 

10 PRINT trms IS A PRtXniAH" 

) 

Row type another escape I) to move the cufsor to the empty line Just above 
the current line and the display will look like: 

JLIST 10 

■ 

10 PRiriT ^THIS IS A PROGRAM" 



Type the characters to be Inserted which. In this case, are TAB<10);. «oiir 
TV display should nov look like thle: 

ILIST Ifl 

TABU 01} ;l 
]tf PRIHT "THIS IS A PROGRAM" 



Type An escape C to pmve the cursor down one line bo that the display looks 
like this; 

ILIST 10 

TAB<10); 
llf PRINT "THIS I5BA PROGRAM" 



fcr « 
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Now baClcGpace back to the first quotation aark using escape B {uatn^ thtf 
le*t-arfaw key here «Duld delete Che charaeters yoti have just typed). The 
TV display will now look like thta! 

ILIST 10 

TABdfl); 
10 PRINT itHIS IS A PROGRAM" 

J 

From here, cOpy che rest of the line using the right-arrow and repeat key" 
until the display looks like this: 

]UST 10 

TABdfl); 
Ifl FRtNT "THIS IS A PROCRAH"! 

1 

Deptees the RETURN key and typ« LIST to get Che following: 

ILIST 

1 

10 PRINT TAB( lfl);"THIS IS A 1^ 

OGRAH" 
20 GOTO 19 



Where you wlflh CO avoid copying extra spacee which the LIST format 
introduces into the middle of lines (such aa thoae between Che R and the 
of PROGRAM, in the example above)f u9e escape A. Escape A moves the curaof 
to the right without copying characters. This can be especially iiaeful 
when topylna PaiNT^ INPUT and RfM fftatemenCB, where APPLESOFT doea nac 
ignore extra spaces- 

Ramembetk u&ing the escape keya, one may copy and edit text that is 
diaplayed anywhece on the TV display. 



Appendix C: Error Message 
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After an error occurs, BASIC returns co command level as indicated by the ] 
prompc character and a flashing cursor. Variable values and the program 
text remain iRtacC* but the program can not be continued and all CQSlJB and 
FOH loop counters ate set to 0, 

To avoid this interruption in a running prograot, the (3KEKR GOTO statement 
can be used. In conjunction with an error-handling routine. 

When an error occurs tn an ItM^diace-execution statement, no line number la 
printed. 

Format of error mesedgce; 

Immediate-execution Statement ?XX £KBOft 

l>eCeTred''execuC£on Statement 7XX ERROR IN YY 

In both of the above examples, "XX" Ig the name of the specific erroti "YY" 
is the line fluiBber of the (ieferred-execuClon statement where the error 
occurred^ Errors In a deferred-execution statement are not detected until 
that statement is execucedt 

The following are the possible error ci^des and their meanln^B. 

CAN'T CONTINUE 

Attempt to continue a program when none existed, or after an error occurred, 
or after a line was deleted from or added to a prograiQi 



DIVISION BY ZERO 

Dividing by zero is an error. 

ILLEGAL DIRECT 

You cannot UBe an IHFUT» DEF FN, GET or DATA scatemenc as an 
Immedlatc'-executlon command. 

ILLEGAL QUANTITY 



ThLi parareecer passed to a math OT Btrltlg function U&S Out of range. 
QUANTITY errors can occur due to: 

a) a negative array SlTbSCRIFT (e.g., LET A(-l)-0) 

b) using LOG with a negative or zero argument 

c) using S'Cp. with a negative argument 

tt) A"B with A negative and B not an Integer 

e) use of KIDS, LEFTS, HlCHTj. WAIT, PEEK, POKE, TAB, SPC, 

ON... Goto, or any of the graphics functions with an 

iii^ro[ier argument. 
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HEXr WITHOUT FOR 

The variable in s NEXT scatenent did not correspond to the variable In a FOR 
BtatQmenc which uas sclll in effect, or a namelesB HZXI did correspond to 
any FOR vhich was still In effect* 



OUT OF DATA 

A READ stateaenc was executed but all of the Data statfinenFB in the progran 
had already been read. The program tried to read too much data or 
insufflcienl data waa inf^ltided in th& program> 



Oirr OF MEMORY 

Any ol the following can cause this error: program too large; Coo many 
variables; FOR loops nesced more than 19 levels deep; GQSUfi's neated mori' 
than 2^ levels deep; too complicated an expression; parentheses nested more 
ttisTi 36 levels deep; attempt to set LOKRM: too hlgln; attempt to set LOMDll 
lower than present value; attempt to set HIM£M: con low. 



FORMULA TOO COMPLEX 

More than two Btatementti oC the form IF '"XK" THIlK were executed* 

OVERFLOW 

The result of a ealeulatlon was coo large to be repreaenred In BASIC'S 
number format. X£ an underflow occurs, zero 1b given as the result and 
execution continues without any error message being printed. 



Er-a 



E- m 



SAB SUBSCHIPT 

An attempt was matte to referenee BU array element which Is outside the 
diinerslons of th« array- Thle error can occur If the wrong number of 
dimensions are used in an array reference; for inBtance> LET A{K)|1]'Z when 
A has been dimensioned using DIM A(2,2)t 



^VnTA>! error 

Hlssinft parenchesis in an expression, illegal character in a line, incorrect 
punctuation, etc* 



TYPE HISHATCK 

The left-hand side of an aasignment statement was a numeric VBrlable end the 
right-hand side was a string, or vice versa; or a function which expected a 
string afgumeoC was given a nunerlc one or vice versa. 

UHDEF'D STATBJErifT 

An attefopt was made to GOTO, COSUB or THEH to a StBtement line number which 
does not cxlst< 



UNDEF'D FUNCTION 

Reference ua:S made to a user-defined fuccion which had never heen defined- 



R.EDIH'D ARRAY 

After an array was dimensioned, another dimension statement for the same 
array was encountered* This error ofeen occurs If an array has been given 
the defaul t dimension 1(1 because a statement like A(l)-3 Is f olloUed later 
in the progr^ta by a DIM A(L()0^- This error message can provG useful if you 
wish to discover on what prograa tine a certain array was dimensioned: Just 
Insert a dimension statement for that array in the first line, RUN the 
prograTD, and APPLESOFT will tell you where the original dimension statement 
Is. 



RETURN WITHOUT GOSUB 

A RETURN atatement was encountered ulth>aut a corresponding GOSUB statement 
being executed. 



E- 

C - 



STRING TOO LONG 

Attempt was made by use of thfl concatenation operstor to create a string 
more than 2it characters longo 
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Appendix D: Space Savers 



SPACE HINTS 

In order Co make your progrfliE fit Into less memory space, the EolLowlng 
hints may he useful. However, the first two space-savers should be 
considered only when faced with Eerloua space limitations. Serious 
prosraianiers often Ittep two verslotie of thelt Tsroarams: one expanded and 
heavily documented {with REM's), the othet "crunched" to use the mintraum 
memory apace- 

L) Use multiple staceiientg per line. Thetc Is a small amount of ovcrtiead 
(5 bytes) associated with each line In the program. Two of chege five bytea 
contain the line number of the line in binary. This means that no natter 
how many digits you have lo your line number (minloiuri line number la D^ 
maximum ia 65529), it takes the same number of bytes (two>. Putting aa ranny 
statements as possible on eech IItic will cut down on the number of bytes 
used by your program. (A aitSBle line can Include up to 239 characters,) 

Hotel combining many atateraents on one line makes editing, find other chansoii 
very difficuU. It also makes a program very difficult to read and 
understand, not only for others but also for you iriien you return to the 
program later on- 

2) Delete all REM statements. Each REH statement uses at least one byte 
plus Che number of bytes in th« common text. For instance, the statement 
130 EEH THIS 15 A COHHEUT wses up 24 bytes of memoty- Ln Che statement 

l^d X-X+Y; REM UPDATE SIM 
the RH1 uaes 12 bytes of aeaoty including the colon before the BEM. 

Note! like Bultiple-llne programs, e program without detailed REM Beatemonce 
Is very difficult to read and underscand, not only for others but also for 
you when you return to the program later on. 

3i Use intejet In&tea^ of real arrays wherever possible (see Storage 
Allocation InformatiCFn, later in this appendix)* 

4> Use variables instead of constants. Suppose you use the constant 
3. U159 ten times in your program. If ycu insert a statement 

14 P-3. 14159 
in the program, and use P instead of 3. U159 each time it Is needed, you 
will save lit bytca- This will also result in a speed improvement. 

5) A program need not end with an EMD: ao 
program may he deleted. 

63 Re-tise the same variables. If you have a variable T which is used to 
hold 6 temporary result in one part of the program and you need a temporary 
variable later In your program, use it again. Or, If you are asking the 
computer's Hser to give a YES or NO answer to two different tjueations at two 
different times during the execution of the program, use the same temporary 
vatlahle AS to store the reply. 



an ENU statement at the end tif 



£' 



1=^ a 



1= 



7) Use COSUB's to execute sections of program statements that pecform 
Identical actions. 

S) Use the zero elements of matrices; for instance, A(d), BfO^X). 

9) When AS-"CAT" is reassigned to AS»"I>OC" the old string "CAT" is not 
erased from memory. Using a statement of tbe form 

X - FRE(9) 
periodically within your program win cause APPLESOFT to "bouse clean" old 
strings from the top of memory. 



STORAGE ALLOCATION INFORMATION 

Simple (non-array} real, incegerj or string variables like V, VI, or V5 use 
7 bytes. Real variables use 2 bytes far the variable name and 5 bytes for 
Ehe value (1 sxpan^f^t, 4 ei^iitiaea), Integec variablea use 2 byt^a fpr the 
variable name, two bytes for the value, and have ^'b in the remaining three 
bytes. String variables use 2 bytes for the variable name, I byte for the 
length of the string, 2 bytes for a pointer to the location of ehe string In 
memory, and have fl's In the temeinlng 2 bytes. Sec page 137 for map. 

Real array variables use a minimum of 12 bytea: two bytea for the variable 
name, two for the size of the array, ocic for the number of dimensions, two 
for the sfze of each dimension, and five bytes for each array element. 
Integer array variables use only 2 bytes for each array element. String 
array variables use 3 bytes for each array element: one for length, two for 
a pointer. See page 137 for map, 

String variables, whether sickle or array, use one byce of tneoory for each 
dharacter in the string. The strings themselves are located In order of 
occurence In the prograc, beginning ac KIMETt:. 

When a neu function Ie defined by s DEF statement, 6 bytes ate used to store 
the pointer to the definitfon. 

Reserved words such as FOR, GOTO or BOT, and the names of the intrinsic 
functions such as COS, INT and SIRS take up only one byte of prograci 
storage. Al 1 other characters in ptograciB use one byte oi prograia storage 
each' 

When a program la being executed, space Is dynamically allocated on the 
stacik as follows: 

I> Each active K)R,..NEXI loop uses lb bytes. 

2) Each active COSyB <one that has noc RETURNed yet) uses 6 bytes. 

3> Each parenthesid encountered in an expression uses 4 bytea and each 
temporary result calculated in an expression uses 12 bytes- 
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Appendix E: Speeding Up Your Program 



Tlie hints below should improve che execucion time of your BASIC ptogramH, 
Note that soidb oE these hints are the same as Chose used to decteas*? che 
memBry space used ^y yout prograics. This means that in fflany cases you can 
increase the speed of yqur programs at the same time you improve the 
efficiency o£ their memory use. 

1) THIS IS PROBABLY THE HOST rMPORTAHT SPEED HlfTf BY A FACTOR OF 10: use 
variables instead of conscanes. IC takes more clme to convert a constant to 
Its fioaiting pDlat (real number) representation Chan It does to Ectch the 
value of a simple or array variable. This is especiaily important within 
FOR.. -NEXT loops or other code that is executed repeatedly. 

2) Variables which are encountered firfeC during the execution of a BASXC 
prograra are allocated at the fitart oi the variable table- This meana that a 
statement such ms 

5 A-(»;B-A:C-A 

uill place A first, B second, and C third in che variable tabl« (asaumlna 
line 3 is che first staceweot executed in the program). Later in the 
profiram, when BASIC fiods a reference to the variable A, it will search only 
one entry in the variable table to find A, two entries to find B and three 
entries to find C, etc* 

3) Use HEXT atatements without che index variable- NEXT Is somewhat faster 
chflCJ HEXT I because no check is made to see if the variable specified In the 
TJEXT is the same a& the variable in the most recent stlll-attlve FOR 
statement- 

4> During program execution, uheo APPLESOFT encounters a new line reference 
Huch as "KiTD 1999" It scans the entire user program starting at the lowest 
line until it finds the referenced ILne number (18(10, in this eKeraple). 
Therefore, f re(|uentiy-r€ferenced lines should be placed as early in the 
progcaa as possible- 
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Appendix F: Decimal Tokens For Keywords 



decimal 


token 


kevword 


12& 


EKD 


U9 


FOR 


13fl 


HEXT 


131 


DATA 


132 


IHPUT 


133 


DEL 


L34 


DIH 


135 


READ 


136 


GR 


137 


TEXT 


138 


FS# 


139 


INf 


Ud 


CALL 


Rl 


PLOT 


142 


HLIN 


U3 


VLXN 


U4 


HER 2 


llti 


HGR 


Iftft 


HCOLOR- 


147 


HPLOT 


I4B 


DRAW 


149 


JCDRAW 


1511 


HTAB 


131 


HOME 


152 


ROT- 


153 


SCALE - 


154 


SHLOAD 


135 


TRACE 


13b 


NOTRACE 


157 


NORHAL 


159 


IHVEBSE 


159 


FLASH 


160 


COLOR* 


161 


FOP 


162 


VTAB 


163 


HIMEH: 



decimal 




token 


keyw^ord 


164 


LOMEH: 


165 


ONERS 


166 


RESUME 


le; 


RECALL 


168 


£T«IE 


16» 


SPEED- 


I7d 


LET 


171 


GOTO 


172 


RUM 


173 


IF 


17A 


RESTORE 


175 


& 


176 


GOSUS 


177 


BETURTJ 


17B 


SEH 


179 


STOP 


180 


ON 


181 


WAIT 


LfiZ 


LOAD 


1A3 


SAVE 


IA« 


DEF 


IW 


POKE 


1&& 


PRINT 


1B7 


CONT 


1«S 


LIST 


189 


CLEAR 


190 


GET 


1*1 


HEV 


192 


TAB{ 


193 


TO 


19A 


FN 


193 


SPC( 


196 


THEN 


197 


AT 


198 


NOT 


t99 


STEP 



decimel 




token 


keyword 


204 


+ 


201 


- 


202 


A 


203 


/ 


20A 


'^ 


205 


AND 


206 


OR 


207 


> 


20$ 


- 


209 


< 


!H» 


SGH 


211 


INT 


212 


ABS 


213 


11 sa 


2U 


FRE 


215 


5CRN( 


216 


PDL 


217 


PQS 


218 


SQB 


219 


RN1> 


219 


LOG 


22i 


EXP 


222 


COS 


223 


SIN 


224 


TAN 


225 


ATN 


226 


PEEK 


227 


LEN 


228 


STR$ 


229 


VAL 


23fl 


ASC 


231 


CblRS 


232 


LEFT$ 


233 


RIGHTS 


234 


hid; 
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Appendix G: Reserved Words in APPLESOFT 



I: 


£ 


I; 


£ 


I: 


m 


s- 


m 



.4 














ABS 


AHQ 


hSC 


AX 


ATN 






GAU. 


CHR$ 


CLEAR 


COLOR- 


com 


COS 




O^QA 


DEF 


DBL 


DIH 


DRAW 






Sim 


EXF 












FLASU 


FN 


FOR 


PRE 








om 


COSUB 


GOTO 


GR 








aCOLDR" 


HGR 


ISGR3 


HIM EM: 


HLIN 


KOME 


HPLOT 


17 


INf 


INPUT 


IKT 


INVERSE 






LEFTS 


LEN 


LET 


LIST 


LOAD 


LOC 


LOMEH: 


mtt^ 














MB» 


NEXT 


NORMAL 


NOT 


NOTRAGE 






OK 


OJJERR 


OS. 










FDL 


PEEK 


PLOT 


POKE 


POP 


POS 


PRINT 


BRAD 


RECALL 
RND 


ROT- 


RESTORE 
RUS 


RESUME 


RETURN 


11IGHT$ 


S&^ 


SCALE- 
SPEED- 


SCRN< 

SQR 


SGH 
STtP 


SHlDAQ 
STOP 


SIK 
STOKE 


SPC( 
STRS 


U&< 


lAH 


lEXT 


THEN 


TO 


TRACE 




V8B 














VAL 


VLIH 


VTAB 










VAIT 














XPLQT 


XDRAW 













PRf 
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APPLESOFT "tokeniEes" tViese reeecved Words! eilttl uord cakes up only one byte 
of program storage. All other characters In proerain aCoragc use up one byte 
of program scorafie each* See Appendix F for re served -word tokens- 



The ampeTS&nd < & ) is Intended for the computer's Internai use only; it la 

not a proper APPLESOFT gpiBinsrid. This syrnbol , when executied as an 

insttuctlon, cSyses aa unconditional junp to locstton 33F5. Use reset Ctrl 
C return to recover. 

XPLOT is a reserved word that does not correspond to a current APPLESOFT 
connand. 

Some reserved words are recognized by APPLESOFT only in certain contexts. 

COLOR, HCOLOR, SCALE, SPEED, add ROT 

parse as reserved words only if the next non— space 
character la the replaceraenC sign, - . This ia of 
little benefit In the case of COLOR and HCOLORi as 
the Included reserved word OR prevents their use in 
variable nantfrs apyuay. 

SCRIJ, SPC and TAB 

P^arse as reserved words only If ihe next non-space 
cttBTactet la a left parenthesis. < ■ 

HIMEM! nust have Its colon ( : ) to be parsed as a reserved 
word* 

LOhLEKi also requires a colon ( : ) ii it la to be parsed as 
a reserved word. 

ATfJ is parsed as reserved word only if there ia no space 

between the T and the N- If a apace occurs between ttie 
T and the S, rhe reserved word AT is parsed. Instead 
of ATN. 

TO Ib parsed as a reaerved word Tinless preceded by an 

A and there is a space between the T and the 0. If a 
space occurs between the T and the 0, the reserved word 
AT ia parsed instead oi TO* 

Sometimes parentheses can be used to get around reaerved uocds: 

109 FOR A - LOFT OR CAT TO 15 

LlSTs as Ldd FOR A - LOF TO RC AT TO 15 

but 199 S'OR A - (LOFT) OR (GAt> TO 15 

LISTS as 19(1 FDR A - <LOFT) OH (C AT ) TO 1 5 
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Appendix H: Converting BASIC Programs to APPLESOFT 



Thaugh inplefflenEaCldnS of BASIC on different computers are in many waytf 
alnilar, there are satoe IncompaCiblil ties which you Should uaCch £o( if yini 
are planiUng CO cOnV«tt BA&IC programs to APPLESOFT. 



L) Array (matrix] subscripts. Soae BASlCs us^ "(" and 
flubserlpte- APPLESOFT uses "(" and ")". 



'1" CO denDtL- attay 



2) ScringBt A nuTober of BASICs force you to dlineTiBlon {declare) thi: ItrnKtli 
oE strings before you use t^ein< You should remove all dimensioTi stateiCLGnCH 
of thia type from the program. In some of theae BASICs. a declaration ol 
the forn DIM ASCI, J) declares a string array of J elements each of whitii hrtH 
a length I. Convert DIM statemenCB d£ ihia lype to equivalent ones in 
APPLESOFT: DtH AS (J). 



APPLESOFT uses "+" for String concatenation » not 



"S". 



APPLESOFT uses LEFTS, RIGHTS and MID? to take Bubstrings of atrlns^- Ocher 
BASICS use AS(1) to access the Ilh chacactet of the string AS, and AS(I,J) 
to taVe a substring of AS from character position I to character position J. 
Convert as follow^: 



OLB 
AS(!> 

Asa.j) 



HEW 
HII»$(A$,I,1) 
Ht»$(AS,ifJ-I+l) 



This aasutaes chat the reference to a Bubstrlng of A$ 1b In an expression or 

ia on the right side of an assignment. If the reference to A^ ia on Che 

left-hand side of an assignment, and XS is the String expression used to 
replace characters In ASt converc as follous* 

OLD NEW 

A$a)-K$ AS-LEFTS<AS,l-l)+XS-HUD&{AS»H-l) 

AS(I,J)-X& AS-LEFTS(AS.l-l)+XS-miDSCA*,J+l) 



:• 4 
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3) Some BA^lCs allou "ntultlple assignment" BtatementB of the form 

500 LET B - C " 9 

This statement wauld set both the varlabl<;s B and C to s&ro- 

In APPLESOFT BASIC this has an entirely different effect- All the -'b to 
the right of the first one would be interpreted as logical comparison 
operatare. This would set the variable B to -1 If C equaled (I, If C did 
not equal 9y B would be set to 0. 

The easiest way to convert statements like this one is to rewrite chera as 
follawa: 

500 q - 9 : a - C 

6) Some BASICS use *V" instead of ":" to delimIC mulcllil? ststements per 
line. Chaofte each "/" to ":" in the program. 

5) FrograiiE which use the HAT functions availeble lo some BASICs will have 
to be rewritcen using FOfl...NE]a' loops to perfotft Che appropriate 
operaeionB. 
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Appendix I: Memory Map 



DIAGHAM OF APPLESOFT PROGRAM MEMORY MAP 



Cassette 
Version 



MEMORY RAHCE DESCRIPIIOW 

C^dFF Program work space: noc available to user. 

2(lfl.2ff Keyboard character buffer, 

3flff. 3Fr Available Co u^er for short oachlne 

latiguftge pri!ie,raiit9. 

401I« ?FF Screen display area for page 1 text or color grapblcs* 

BStJi. 2FFF Ln caasfitt? cape verslan, ch& 

APPLESOFT BASIC Incepreter. 

81W.XXX If flrtrtware APPLESOFT fParC nviiober A2B00a9X) iTiStalled, 

user program and variable &pac?, where Xxx is maximutn 
RAM iBtmory to he uSdd by APPLESOFT. This is either 
total system RAM memory, or less If the user is 
reserving part of high memory for machine language 
routines or hlgh-reS'Olut Ion screen buffers* 

21W.3FFF FirruMare APPLESOFT only: lilgh-reaolutlon 

graphics display page 1. 

30a0<XXX Cassette tape APPLESOFT II; 

user program and variables where XXX 

Is maximum avDlleble RAH Tnemory to be 

used by APPLESOFT. This is either total 

aystem RAM memory, or leas if the user 1» 

reserving part of High memory for roacHlne 

language routines or page 2 high-resolution graphics* 

4W(|.5FFF High-resoliitlon graphiCB display page 2. 

C00(I.CFFF Hardware 1/0 Addresses. 

D||(i;|.DFPF FoCufe KOH expan&lon- 

D000.F7FF APPLESOFT IT firmware version, with select 

switch "OH" (up)4 

EMB.FTFF APPLE Integer BASIC. 

Fe01l*rFFF APPLE System Monitor. 
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$3901 

S2FFF 
$SI»1 



pointer 



Disk Operating System 
(if disk is being used] 



S73 - 57'- CHIMEU;) 
IIHEH: Is aucomatlcally set to 
the msxlmuiti ^AM icecnory location 
In the system, unless set by 
the user- 



STUItSCS 
$6F - 5?* 



FREE SPACE 
Including the high-reSolutJon 
grapklca' BCTccn buffers 
(wltli cassette APPLESOFT, 
only, page 2 Is available]. 
MOTE^ String space may fill 
with old data and run over 
the high-resolutiort screens 
or machine programs. To 
initiate houee-clcaiMoe atid 
and avoid this problem, Insert 
X-FRE<tf) In your program. 



S6D - S6E 

NU11ERIC AND STRIKG-FDIHTER 
ARRAYS (sec page B?) 

see - $6C 



SIMPLE VARIABLES (See page 137) 
S69 - 56A aOMEH:> 



5AF - SQl* 

PBOGBAH 
S67 - 568 



APPLESOFT 



f Irntware: 
version 



$601 
F7FF 

D999 
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Appendix J; PEEKs, POKEs, ond CALU 



Here are a EeW pf the special Eeatures o£ APPLESOFT t>iaC you can use by 
nearis of PEEK. POKE, or CALL cDiniaflTids. Notice thsc some of ctien duplicate 
the effects of other coainands In APPLESOFT. 

Simple awlictiing actlOrts ara usually addresa dependent: any comnand 
involvine that address will have the aame effect on the switch. Thus, the 
example taay be 

POKE -I6i9^t * . 

but you uill aet nhe same effect by POKElng that address with any number 
from through 255, or by PEEKing that address: 

X - PEEKt-163&i) ^ ^ ^^ 

This does not apply tt> coamandB In which yoy must POKE the required address 
with a specific value which sets a marftln or movee the eursor to a 
3peciClt place. 



SETTING THE TEXTWINDOW 

The first four POKE comnands, with (jyanple lin« nutBhers 1*, 20, ^fli. .ind iii, 
are used to set the »lie of the "window" in which text Is shown Sfld scrolK'd 
on your TV screen. These set, respecClvi^ly . the left margin, line widths 
lop margin and hottom coargin of the tfindow* 

Setting the text window does not clear the remainder of the screen, and does 
ooC nove the cursor Into the text window (use HOME, or HTAB and VTAB). The 
VTAB i^ommand Ignores the text window entirely: text printed above the window 
appears norraally, while text printed below the window appears all oa one 
line. HTAB can also move the cursor outside the Window, but only long 
ennu{;h to print one character there. 

A change in line Width goes into effect tnnsedlately . but a change in the 
left margin Is not detected until the cur&or tries to "return" to the left 
inaTgin. 

TeKt displayed on the IV screen is merely a special map of a particular ^^ 
portion of apple's memory {text page 1). The tV acreen always "looka at 
this sacne portion of raenory for Ice text, and sees what the APPLE has 
"written" there. When you change Che text window, you are telling the APFLL 
where in nesiory to "write" its text. This works fire* a& long as you 
specify a pc-rtlon of memory that Is within the usual text area. Bat If 
you Bet the left margin. aay» to 25^ (the Eiaxlmum should be ^0, since Eh* 
screen l3 Ad print-positions wide), you arc teilins the APPLE to write 
text far beyond the u3^al muxaoty area reserved for text. This memory is not 
shown on the screen, and may contain parte of your program or even 
inforoation necessary to APPLESOFT itself. To ^eep your program and 
APPLESort safe, just refrain from aetCioa the text window beygrid the 
confines of the 40-character by Z4-llne screen. 
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Id POKE 32, I 

Seta left margin of TV display to value specified by L, in the range from (I 
through 39, where is leftmost position. This change Is not effected untH 
die cursor attempts to "return" to the left margln> 



^ 



The width of the window is not changed by chis command: this mean^j 
that Che right margin will be moved by the sane amount ynu move the left 
mJirgln. To preserve your program and APPLESOFT, first reduce the window 
wldnh appropriately; then change the left margin. 

Zti POKE 33, H 

Set© the width (nviDber of cheracters per line) af TV display to the value 
specified by U, in the range from I through <i0- 



Uo not set H to zero: POKE 33, fl bombs APPLESOFT. 



® 



li W is less Chan 33, the PRINT command's third cab-field may print 
characters outside the window. 



30 l-OKE 3*1 , 1 

^Gta top margin of TV display to value specified by T, in the- range from i 
through 23 where is the top line on the screen. A POKE 34, A will not 
allow text to be printed In the first four lines of the screen. Co not set 
the top margin of the Window (T) loWer than the tjottoia Biargln (&, below}. 

fttf POKE 35, B 

Sets bottoiB margin of TV display to value Specified by B, in the range from 
through 24 where 2A la the bottom Eine on the screen. Do not set the 
hiTttnn margin of the window (B} higher than the top margin (T, above). 



OTHER COMMANDS AFFECTrNG TEXT, THE TEXTWINDOW, 
AND THE KEYBOARD 

!tb CALL -936 

Clears all characters Inside the text window, and Tnovee the cursor to the 
window's top leftmost printing position. This is the same as esc @ return 
(Kscapc f) and the command HOME. 



12a 



3 



129 



50 CALL -958 

Clears all charaectrs Inside of text window from current cux&or position to 
boccom margin. Characters above the cursot, and characters to the left of 
Che cursor in Its printing line uill not be affected. This is the sane as 
esc F {Escape F>. 

1£ the cuESor is above the tei^t vindau, clears fcom the cutsot to the right, 
left and bottom margins as If the Cop margin were above the cursor. It Is 
Dot usually desirable to use thlG (^omoanid if t'hs Gur9or i& below the botton 
aargin ot the text window: usually Che bottom line al the text wltidou 1a 
cleaned, along with one line of text^wlndow vldch at the cursor poaltloiv. 



60 CALL -8fi8 

Clears current line from cursor to right 
(Escape E). 



nargia- This is the same aa esc E 



70 CALL -922 

Issues a line feed. This Is the same as tcrl J (Control J), 



I; 

It 



3 
3 

3 



cursor's position telatlve CO the text window's left-hand margin, as sec by 
POKE 32, L. Thus, If ihe left aargid was set by POKE 32^5 then the leftmost 
character In the window is at the 6ch ptlciclng-posl clon from the left edge 
o^i the screen and if PEEK <36) returned a value of S then the cursor was at 
the Uch prlntlng-poeltlon fron the left edge vf the screen and at the 6ch 
printing position from the left margin of the text window. <lt sf^unds 
confuBing at first, because the lefcmosc position iB position zero, not I^O 
This la identical to the PaS(X> function. CSee next example- > 



120 POKE 36, CH 

Moves Che cursor to a position that is CH+1 prlnt£ng~poalt£otis fr^m Che left 
margin of the text window- (EnampleJ POKE 36,9 will cause next character to 
be prlntEd at the left margin of the Window.) If the left margin of the 
window was set at 6 (POKE 32, b) and you wanted to provide a character three 
posltlone from left edge of tlie screen, then the window's left margin must 
be changed prior to rRll4Ting. CH must be less than or equal to the window 
width as set by POKE 22, W and must be greater than or equal to zero- Like 
H7AB, this command can moue the cursor beyond the right margin o£ the text 
window, but only long enough to print one character. 



80 CALL -912 

Scrolls text up one line; i.e., moves each line of text within the defined 

window up one position. Old top line la loet; old second line becomes line 

one; bottom line is now blanks Characters outside defined window are not 
affected. 



9fl X - PEEK{-16384) 

Reads keyboard. If X>127 then a key has been pressed, and X Is ASCII value 
of key pressed with bit 7 set (one). Thi9 19 useful in leng ptograms h in 
which the computer checks to see if the user wants Co interrupt with new 
data without stopping prograni execution. 

100 POKE -16366.0 

Resets keyboard strobe so that next character may be read In, This should 
be done iomediacely after reading the keyboard* 



COMMANDS THAT DEAL WITH THE CURSOR 

110 CH - |'BEK(i6) 

Keads back the current horlzontat position of the cursor and sets variable 
CH equal to It. CH will be In the range from 9 through 39 and is the 
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I3i CV - F£EK(37> 

Reads the current vertical position of the cursor and sets CV equal to It- 
CV is the abaoliite vertical position of the cursor and is not referenced to 
the top or bottom niarglnS of the text window- Thus CV-fl is top line on 
screen and CV'-23 is boccon. 



140 POKE 37, CV 

Moves the cursor to the absolute vertical position specified by cV. 
the topmost line and 23 is the bottom line. 



^ iQ 



COMMANDS AFFECTINO GRAPHICS 

For purposes of displaying text and graphics, ch 
into i* areas; text pages 1 artd 2» and hlgh-resol 

1) Text page L Is the usual menory area Eoc 
graphicST ss used by the TEXT and CR corrmiandS' 

2) Text page 2 lies Just above text page I 
accessible to the user. Like tent page I, Infor 
can be interpreted either as text or as low-reso 

3) High-resolution graphics page I resides 
Ibk. This is the area used by the HCR connand< 
pjjge, it comea from text page L. 

&) High— resolution graphics page 2 resides 
CO 24k. This is the area used by the ILGR2 comcui 
this page, it comea from text page 2. 
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e apple's memory Is divided 
utlon pages 1 and 2. 
all text and loW'^rcsoluClon 

In memory. It Is not easily 
nation stored In text page 2 
lucion graphics, or both. 
in apple's memory from 8k to 
If text le shown with this 

In apple's memory from 16k 
ndr If text ia shown with 



To use th« different graphics and texc madeg, you can use APPLESOFT'S text 
and graphics commandB or you can operate these 4 different switches. As 
with many of the switches discussed here, a PEEK or POKE to one address sees 
the switch one way, and a PEEK or POKE to a second addreas sets the switch 
the other way. In hrlef, these A switches choose betueeot 



(POKE --16303,*)) 
(POKE -16304, (*) 
(POKE -163W,a) 
(POKE -1&299,(J1 
<POKE -L62gS,|!) 
(POKE -16297,! 



1) Test display 

and Graphics display, high- or low-reeolution 

2} Page I of text or high-resplucion 

and Page 3 of text or high-resolution 

3) Text page i or 2 for graphics 

and High-resolution page I or 2 for graphics 

^) Full-screen high- or low-resolution graphics (POJt£ -163921^) 

and Hlxed high- or low-reaolytion graphlcs+Eext (POKE -16101,0) 

150 POKE -16344.0 

Switches dlepley mode from text Co color gtaphiea vlthouc cleaT-lnB, chs 
graphics screen to black. Depending on the settings of the other 3. 
sulccheB, Che graphics inode switched to may be low-resolution or 
high-resolytion, from page 1 or 2, and In mixed graphlcs+texc or full-stCfifla 
graphics. 

Siailar APPLESOFT conimands: The CR command switches to page 1 
low-resolution, mixed-screen graphlcs+text, and clears graphics acreen to 
black. The HGR dOmmand switches to page ! high-resolution, ralxod-acreen 
graphlcs+text, and clears graphics screen to black. The HGR2 comniand 
switches to page 2 hlgh-rcaolutlon, fyll-screen graphics and clears entire 
screen to black. 



160 POKE -16303,0 

Switches display mode Eron any color graiphlcs dlaplsy to all text inade 
without resetting scrolling wlndou. Depending on the setting of the Page 
l/Page Z switch, the text page switched to may be either teat pege I or t- 
page 1, 



text 



The TEXT command switches to all text mode, but io dilditlon chooses text 
page 1, reset* scrolliig window CO oaKlmum and positions cursor Iti lower 
left-hand corner of TV display. 

170 POKE -lf^i92,9 

Switches from mixed-screen grnphics+text to full-screen graphics. 

Depending on the Bettings of the other switches, this may appear as text, a 
low-cesolutJpo graphics on a 40 by (t& grid, or aa hlgh-reaoliiclon sraphlcs 
on a 278 by 19? grid. 
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iSi POKE -16301,0 

Switches from full— screen graphics to mixed—screen graph! cB'4- text mode, 
four 40-chaTacter lines of text at bottom of Screen. 



with 



Depending on the settings of the other switches, the upper portion of the 
screen may show text, low-reaolutlon graphics on a 40 by 40 grid, or 
hlgh-resoluclon graphics on a 278 by 160 grid. BoCh portions of the screen 
dl&play will come froto the same page number (1 or 2). 

LS4 POKE -16300,0 

Switches from Page 2 to Page 1, without clearing thi dcteen or moving the 
cursor. Necessary when you go into Integer BASIC from APPLESOFT; otherwise 
you may still be "locking" at page 2 of memory. 

Depending on the settings of the otheir switched, thi« <:»f< taus^ the display 
to change from high-resolution graphics page 2 to high-resolutlon graphics 
pa^e I, from low-tesolotlon graphics page 2 to low-resolution graphics page 

1, or from text page 2 to tCXt page 1. 

186 POKE -16299.0 

Switches from Page i to Page 2, without clearing the screen or moving the 
cursor. 

Depending on the settings of the other swltcheB, this can cause the display 
to change frOB high-resolution graphics page 1 to high-resolution graphics 
page 2, frotn low-resolution graphics page I to low-resolution graphics page 

2, or from text page 1 to text page 2- 

L90 POKE -1629B.0 

Switches the page for graphics £rom a high-resoliitlon graphics page to the 
same page of text, without clearing the screen. Necessary when you go into 
Integer BASIC from APPLESOFT: otherwise the Integer BASIC GR Ifiatructlon may 
incorrectly show yow the high-resolution page. 

Depending on the settings of the other switches, this may cause the display 
to change Iron high-resolution graphics page 1 to lowTesoJutlon graphics 
page 1, from high-resolution graphics page 2 to low-resolution graphics page 
2r or (In text mode) may cause no change in the display. 

ISb POKE -16297. # 

Quitches the page for graphics from a text page to the corresponding page of 
high-resolution^ without clearing the screen. 

Depending on the settings of the other switches, this may cause the display 
to change from lou-resolutlon graphics page I to high-resolution graphics 
page 1, from low-resolution graphics page 2 to high-resolution graphics page 
2, or (in text tnode> may cause no change in the display. 
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2« CALL -1994 

Clears the upper 2(1 line? of text page 1 to reversed ^3 signs. If you are In 
page 1 low-resolution graphics modeT this clears the upper 40 lines oE the 
graphics screen to black. Has no effect on text page 2 or on 
high— resolutloTi graphics . 

2(15 CALL -199B 

Clears entire text pa^e 1 to reversed ^ signs. If you are In page 1 

lov- resolution luH-screen graphics mode, this clears the entire screen to 

black. Has no effect on text page 2 or on hlgh-teeolutlon gcspiilcs. 

200 CALL 624S9 

Clears rurrenc high— T^SiOlueloici s^r^^rt (APPLESOFT tr^tn^tnb&ra "blch screen you 

used lasCt regardless of the ewltch settings) to black. 

214 CALL 6245; 

Clears current hl&h-rc»olution screen (APPLESOFT remembers whicb screen you 
used last, regardlesa of Che switch aettlngs) CO the HCOLOR mast recently 
HPLOTced- Htj9C be preceded by a plot* 

COMMANDS DEALING WITH GAME CONTROLS 
AND SPEAKER 

22ff X - PEEK(-16336) 

Toggles speaker once: produces a "click" from speaker. 

225 X - P£EK(-163S2) 

Toggles casaette-outpuc once: produces a "click" on a cassette recording. 

2jg X - PE&K<-l&2a7> 

Reads pushbutton switch on game control f{). If X>127 then this button Is 
being pressed. 

240 X - PE£):(-1&266) 

Same as above but pushbutton on game control 91* 

250 X - PCEK<-]6263} 

Game control #2 pushbutton. 
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260 POKE -16296,1 

Set game control "annunciator" output 10 (Game I/O connector, pin 15) to TTL 
open-collector Jiifeh (3^5 volts)- This is the "off" condition, 

279 POKE -16295,0 

Set gan* control output #0 to TTL low < .3 volts). This is the "on" 
condition; TaaxlBHam current Lt6 mllllanperea. 



260 POKE -16294,1 

Set game control output It (Cgae I/O connector, pin 14) to TTL high (3*5 
volts). 

290 POKE -16291,0 

Set game control output II to TTL low 10. J volts). 

300 POKE -16292,1 

Set gapw; control output #2 (Came 1 /O cannectoti pin 13) to TTL high (3.5 
volts). 

3l# POKE -16291,0 

Set game control output 12 to TTL low (0,3 VOlCS). 

320 POICE -16290,1 

Set game control oucpui #3 (Game I/O conaector, pin 12) to TTL high (3.5 
volte). 

330 POKE -16289,0 

Set game control output to TTl low {0,3 volts)- 



COMMANDS RELATED TO ERRORS 



340 X - PEEK (218) + PEEK (219) * 256 

ThlB statement sets X equal to the line number o£ the statement where an 
error occurred If an ONERRGOTO statement has been executed. 
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350 IF PEEK {21&>>127 THEN GOTO 20^0 

If bit 7 at menoTy location 222 (ERHEXC) has been Set true, then an 
OHEKKGOTO statement has been encountered. 



360 POKI 216,0 

Cleats EStRFLG So that normal error measages will occur. 

3?0 Y - PEEK (222) 

Sets variable Y to a code that described type oC error that caused an 
ONERRGOTO iMop to occur. Error types are described below: 



APPLESOFT VARIABLE MAPS 



Y VALUE 

9 

16 

22 
«2 
S3 
£9 

n 

9$ 
l»7 
120 
133 

im 

m 

191 
224 
254 
253 



ERROB TYPE EKCQUHTI3.EB; 

NEXT without FOR 
Syntax 

RETURN without GOSUB 

Out af DATA 

Illegal QuanClty 

Overflow 

Out of llemory 

Undefined Statement 

9ad Subecclpc 

Redlisensloned Array 

Dlvlfilort by Zero 

Type Mismatch 

String Tod Long 

Ponmila Too Cooplex 

UndefJficd Function 

Bad Response to an INPUT Statement 

Ctrl C Interrupt AtteEspted 



380 POKE 76a, 3»^ : POKE 769, 166 : POKE 770, 104 : POKE 771, 166 : 

POKE 772, 223 : POKE 773, 154 : POKE 774, 72 : POKE 775, 152 : 
POKE 776, 72 : POKE 777. 96 

Establishes a nachln>e-Language subroutine ai location 76fi, uKlch can be uaed 

in an error-handling routine. Clears up sone OMERR GOTO prablcms witb ra.IKT 

and ?OUT OF HEIIORY ERROR tneeed^es. Use the cODuOand CALL 76B in the 
error-handling routine. 
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SIMPLE VARIABLES 





m 




a 




< 




s 




c 




m 




m 




m 


&= 


s 


E * 


m 


C 


-m 


H« 




« 



POINTERS 


REAL 




IKTECER 


$69-$6A 


IIAllE epos) 
{pas.) 


1st byte 
2nd byce 




NAME Cneg) 1st byte 
Cneg) 2nd byte 




exponent 
mantissa 


1 byte 
tn.s.byte 


high byte 
lou byte 




isantlssa 
mantissa 
fnantlsaa 


l.s.byCe 













HEAL 


S6B-56C 


HAHE (pos) 1st byte 1 
(po&) 2nd byte 1 




OFFSET pointer to 
next variable- ^dd 
to address o£ tliis 
variable name 

low byte 
high tyte 




HO. OF DIHENS10MS 

one byte 




SIZE Ntii DIHEHSSOH 
high byte 
lo« byte 








SIZE iBt DIHEN&IOIJ 
high byte 
ipu byte 




REAL <((,*,, ..0) 

exponent 1 byte 

aacitlssa a.s.byte 

nantlssa 

lunt 1 »sa 

cwntlssa l.s.byte 






56D-S6E 


REAL (tl,H...,N) 

exponent I byte 

nantlssa n.s.bytt 

Tiantlssa 

mantissa 

nantlssa l.g.byte | 



ARRAY VARIABLES 



INTEGER 



HAtlE (neg) 1st byte 
(neal ^"d byte 



OPFSET pointer to 
next variable: add 
to address of this 
variable nane 

low byte 
high byte 



DO. OF DTMEHS10NS 

one byte 



^TTmtTnmiEiJFTUTr 

higb byte 

low bycg 



size: Ut DlHHiSIOK 
high byte 
low byte 



IPJTEGEP.J; (0,0,...?> 

high byte 

tou byte 



IllTECERt (lJ,tl,..,in 

high byte 

\o\i byte 



STB in G POINTERS 



HAHE {neg) lat byte 

{pos} 2nd byte 

length 1 byte 

address low byte 

address high byte 



STRICJC POIHtERS 



HAIIE {neg> lat byte 
(poa) 2nd byte 



OFFSET pointer to 

next variable; odd 

to addreae af this 

variable name 

low byte 
high byce 



NO. OF DlIIEriSIONS 

one byte' 



SIZE tJtii Dintrjsion 

high byte 
low byte 



SIZE let DLMEtlSlON 

high byte 
low byte 



length 1 byte 

address low byte 

addresa hlah hyte 



STRINGS (N,H,.,,M) 
length I byte 

address low byte 

address high byte 



:i 



Strings are stored in order o( ealry, from hltlEIJ: doun. String table points 
to first cliatacter of each string, at the botton o£ the string in memory. 
Ak strings ate changed, new pointing addresses are written; when Hvailable 
mLTK.>ry ie used up, house-cleaning deletes all abandoned strings* 
<Huuae-cleanine is forced by a FREfX)). 



,:i 



All arrays arc stored with the right-most index ascending slowcatj e.g. 
nucibffs in the array AZ(1,1) where A:{B,»)-0. a5<I,»>-1, AX<0,1)-2, 
Ai{l, l>-3 would be found In nemoty in proper aequenco. 
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Appendix K: ASCII Character Codes 



DEC - ASCII declittsl code 
HEX - ASCII hexadeclntal code 
CKAB - ASCII character name 
fl/s » aot accessible directly ttom the *PPLe tl keylioard 



DEC HEX CHAR WHAT TQ TYPE 






00 


NULL 


ecrl 





I 


01 


SOH 


cEirl 


A 


2 


02 


STX 


Ctrl 


a 


3 


03 


ETX 


Ctrl 


c 


4 


04 


ET 


Ctrl 


D 


3 


05 


ENQ 


ccrl 


E 


6 


0& 


ACK 


Ctrl 


F 


7 


P7 


BEL 


ccrl 


G 


8 


0S 


BS 


ccrl 


H or *- 


9 


09 


HT 


Ctrl 


I 


10 


0A 


LF 


cCeI 


J 


U 


0a 


VT 


Ctrl 


K 


[2 


0C 


FF 


Ctrl 


L 


13 


0D 


CB 


Ctrl 


H or RETURH 


1^1 


0E 


SO 


Ctrl 


N 


15 


0F 


SI 


Ctrl 





16 


10 


DLE 


Ctrl 


P 


17 


U 


DCl 


Ctrl 


Q 


le 


12 


DC 2 


Ctrl 


R 


19 


13 


DC 3 


Ctrl 


3 


20 


14 


DC 4 


Ctrl 


T 


21 


15 


NAK 


Ctrl 


U Of — 


22 


16 


SYN 


Ctrl 


V 


23 


17 


ETB 


Ctrl 


W 


24 


18 


CAN 


Ctrl 


X 


25 


19 


EH 


Ctrl 


Y 


26 


lA 


SUB 


Ctrl 


Z 


27 


IB 


ESCAPE 


ESC 




28 


IC 


FS 


n/a 




29 


ID 


G5 


Ctrl 


ahlft-M 


■i9 


IE 


RS 


Ctrl 


"• 


3! 


ir 


US 


n/a 








t ci 

e ;CJ 



BEC HES CKAH WHAT TO TYPE 



space 



32 


29 


SPACE 


s 


33 


21 


I 


^ 


3i 


22 


" 


tr 


35 


23 


t 


f 


36 


24 


s 


5 


3? 


25 


Z 


X 


38 


26 


& 


& 


39 


27 


' 


' 


40 


2B 


( 


t 


41 


29 


) 


) 


42 


2A 


* 


* 


43 


2B 


+ 


+ 


44 


2C 


, 


J 


45 


2D 


- 


- 


46 


2£ 


. 


, 


47 


2F 


/ 


/ 


48 


30 








49 


31 


1 


1 


59 


32 


2 


2 


51 


33 


3 


3 


52 


34 


4 


4 


53 


35 


5 


5 


54 


36 


b 


6 


55 


37 


7 


7 


56 


38 


6 


8 


57 


39 


9 


9 


58 


3A 


: 


s 


59 


3B 


i 


; 


60 


3C 


< 


< 


61 


3ID 


- 


- 


62 


3E 


i 


> 


63 


3F 


7 


t 






^4 



DEC HEX CHAR WHAT TO TYPE 



64 40 

65 41 

66 42 
t>} 43 



64 


44 


69 


45 


70 


46 


71 


47 


12 


4a 


73 


49 


i'4 


4A 


75 


4& 


76 


4C 


77 


4D 


iTU 


4E 



79 4F 
B0 50 



Bi 

B2 



89 
90 
91 
92 



5] 
52 



fti 53 

U 54 

B5 55 

6f> 56 

87 57 

88 58 



59 
5A 

5B 
5C 



A 

B 
C 
D 
E 

F 
C 
H 
1 
4 
K 
T, 
K 
N 

P 

q 

R 
S 
T 
U 
V 
U 
X 

y 



93 5D 

94 5E 

95 5F 



C 
D 
E 
F 
C 
H 
1 
J 
K 
L 
H 
N 

f 
Q 
R 
S 
T 
U 
V 

u 

X 

Y 

Z 

n/a 

n/a 

] (shlft-H) 

n/a 



ASCII codes In the range 96 through 255 will generate characters or the 
APPLE «hich repeat those In the list above (first those In column 2, then 
the entire series again). Although CHR$(65> returns am A and CHK$(193) alst; 
retvrnB an A, APPLESOFT does not recognize the two as the s^oi^ character 
when using string logical operators, and a printer coanected to your APPLE 
Would print them differently- 
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Appendix L: APPLESOFT Zero Page Usage 



LOCATION (a) 

(in hex) USE 

$(|-S5 Jump insCTUcclons Co continue In AFFLESOFt. 

{reeec (JG return for APPLESOFT is equivalent to 
reset Ctrl C return for Integer BASIC*) 

$A»SC Location for USB function's jubp instruc clon* 
See USR function description. 

$D-317 Genecal purpose counters /flags for APPL&SaPt. 

$2IP-$4F APPLE II Bystea Bionitor Eeserved location?- 

$5(1— $61 Gert&ral purpose pointers for APPLESOFT. 

$&2-S6« Result of last mulciply/divldc. 

S67-S68 Potntec to beginning of prograa. Horraally 
set to SflSfll for ROM version, or i^t9i 
for ElAK (cassette tape} version. 

$b9-S6A Poltiter to start of almple variable space. Also 
points to the 6ttd of the progran plus I or 2, 
unless changed with the LOHEHt atatenvent. 

$6B-S6C Pointer to beginning of army space. 

$6D-$6E Folncer to end of numeric storage In use- 

$6F-$7fl Pointer lo stare of sttiitg storage. Strings ate 
stored from here to th£ end of QismoEy. 

$71-^72 General pointer. 

S73-S74 Hlgheat location ifl (nemory available to APPLESOFT 

plus one. UpOfii Initial entry to APPLtSOFT, 19 
sec to the highest HAH naQory location available. 

?75-?7S Current line number of line being eiiecuc^d. 

S77-S78 "OH line number". Set up by a Ctrl C, STOP 

or EtJD stSiteiacat. Cives line number at vhlcb 
execution was intcrrupted- 

S79-$7A "Old text pointer". Points to location In memory 

Cor 9ta:teinent to be executed next> 

S7B-S7C Current line number froH which DATA is being READ. 



{=■ m 




re m 




a 3 


$7D-$7IE 


It a 


S7F-S80 


r§- m 




[i- m 


SBl-$82 
S83-$84 


(• a 


Sft5-59C 


(&- a 


S9D-SA3 
SAi 


i&r a 


SA5-$AB 


IK' m 


SAC-$AE 
SAF-B0 


(E m 


SB1-SC8 


f§- m 


SBa-$B9 


a- m 


3C9-$CD 


[h d 


SlJtf-5D5 




SES-^DF 


(E- m 


SEa-?E2 


ic -a 


%ZI> 




SE5-SE7 




SES-St9 


(t--« 


5EA 


[^m 


5FB-SF3 
SFA-SF8 



Poiflca (0 absolute location In aeiftory from which 
DATA la being READ. 

Pointer to qurcent source of iHPUt. Set to $201 
during an INPUT etatement. During a HEAD 
etatejiient Is set to the DATA In the program 
It is KCAOing from. 

Holds the last-used variable's nacae. 

Pointer to the last-us^ed variable's value> 

General usage. 

Main floating point accumulator. 

General use in floating paint matb rautlnes> 

Secondary floating point accunulator^ 

General usage flags/pointers- 

Pointer to end of program ( not, changed by LOhEM: > 

CHRCET routine. APPLESOFT calls bete 

everytlbe it vaats aoother chscacC'er. 

Pointer to last character obtained through 
the CHRGET rouclna. 

Kandom nuinber> 

Hlgh'^resolution graphics scratch pointers. 
ONERR pointers /scratch. 

High-resolution graptilcs X and Y coordlnatesif 
High-reaolutloti graphics color byie. 
General use for high-resclution graphlca> 
Pointer to beginning of shape table. 
Colliflion counter for high— resolution graphics- 
General use flags. 
OKESR pointers. 
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Appendix M: Differences Between 
APPLESOFT and integer BASIC 

DIFFERENCES BETWEEN COMMANDS 

Theae cominaniis are available in APPLESOFT, but noC In Ititegeir BASIC: 
ATH 



fc 
1= 

lb 
t 



ClSRS 


COS 






DATA 


DEF FH 


aaAH 




EX? 








FLASH 


ETJ 


PRE 




GET 








HCOlflR 


HGS 


l^R2 H1HEH: 


HDHE HPU 


INT 


INVERSE 






LEFTS 


LOG 


LOHEHt 




MID? 








NORMAL 








on»..cosi;b 


ON... GOTO 


ONERa GOTO 


P05 








HEAD 


RECALL 


HESTOB.E RESUME 


RIGHTS ROT 


SCALE 


SHLOAS 


SIN SPC 


SPEED SQR 




STORE 


SIRS 








STOP 



TAH 
OSR' 
TAL 

VAIT 
SURAH 

These commands are available in Integer BASIC, btit not In APPLESOFT: 
AUTO 



L « 



These are nanted differently in the languages: 



Inlenec BASIC 

CLR 

CON 

TAB 

GOTO X*l9+i99 

CDSU& y:*199+l9<i9 

CALL -936 

POKE 5*. 127 

POKE 5fl,255 

X 

f 



AFFLESOFT 

CLtAR 

COST 

HTAft <Noce: APPLESOFT alao has a TAB) 

ON X GOTO 100. 114. 129 

ON X C05UB ll»09, L19^. ]20;» 

HOME (or CALL -936) 

INVERSE 

NORMAL 

XX ( X Indicates Ince^er variable) 

o or >< 



OTHER DIFFERENCES 

Iti Integer BASIC, the eprrectness of a ecacenentii'B syntax is checked when 
the statcioent Is stored lo itic cnfuputer'a nienory (when, you preae the RETURN 
key). In APPLESOFT, ftuch checking Js done when a statement is executed. 



ROTO and GOSUB must be followed by a line ntitoher Ifl APPLESOFT; Integer BASIC 
allows an aclthnetlc varlalle or expression. 

Heal variables and constants ("floating point" numbers with declroal ponta 
nnd/or exponents} are permitted in AFPLESOFI but not in Integer BASIC. 

In APPLESOFT, only the first two characters In a variable name are 

significant (e.g., GOOD and GOUGE are recognised as the same variable hy 

APPLESOFT). In Integer BASIC, all characters in a variable name are 
significant* 

String Operations are differently defined in the two languages. Both 
srrlngs and arrays siust be DIKeneloncd to Inceg'er BASIC; oaly arrays are 
DlHensiontd in APPLESOFT. 



In APPLESOFT^ arrays may be mtiltl-dJoenslonal! io Integer »AS1C> 
limited to one dluenslan. 



arrays are 



AFFLESOFt sets all array elements to zero on executing RUN, CLEjUI, or reset 
Ctrl B return. In Integer BASIC, the user's program must set all array 
elementa to zero. 

When the assertion In an Integer BASIC IF... THEN... statement evaluates as 
iiero (false), only the THEN portion of the statement Is ignored. In 
APPLESOFT, all statenents following a THEN and on the same Una will be 
ignored when the IF assertion evaluates as zero (false): program execution 
jumps to the next numbered prograim line. 

In APPLESOFT, the TRACE command displays the line number of each Individual 
Inscructlon an a multlple-lnstruc tion program line, not Juat the first 

instruction, 59 In Integer BASIC. 

In APPLESOFT, the CALL, PEEK, and POKE commands nay use the true range of 
itieraory location addresses (tJ through 655J5). In Integer BASIC, locations 
with addresses greater than 32 767 rau3t be referred to hy their 
two 'a -complement negative values (location 32763 is called -32767-1; 32769 
is called -32767; 3277fl 1? called -32766; etc.). 

ENP in a program which stops on the highest line number is optional in 
APPLESOFT, but required In all cases to avoid an error message In Integer 
BASIC. 

NEXT must be followed by a variable name in Integer BASIC; a variable name 
is optional in APPLESOFT. 

tn Integer BASIC, the syntax of the INPUT statement ia 

Ht?UT Istrlng.l {war,) 

If var is an avar, then INPUT prints a ? with cr without the optional 

string. If var is a svsr, Lhen no ? Is printed, whether or not the optional 

string i& present. In APPLESOFT, the syntax of the INPUT statement Is 

INPUT [string;! ivar,> 

If the optional string la omitted. APPLESOFT prints a ?; Jf the Optional 

string Is present, no ? Is printed. 
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Appendix N: Alphabetic Glossary of Synfaclic 
Defmitions and Abbreviations 

See Chancer 2 (ox a lc£i'^al (as opposed to alphabetic) presentation oi chcae 
definitions. The symbol :- means "Is at least partially defined ae." 

alphanumeric character 
:- letterl^Igtt 



alop 



aop 



arithmetic logical operator 
i- ANDfOR|-|:'|<|?<:|<>|<-|-<|>-|-> 

NOT iB not included here on purjtooe. 



:- arithmetic opecator 

:-+i-i*i/r 



:* arithmetic varlabi? 

: - name InsneZ 

All ainple variables occupy 7 bytes in memocyi 2 bytes for 
the name and 5 bytes for the real or integer value. 

:- avac subscript 

In arrays^ reals occupy 5 bytes, Integers 2 bytOfl- 



aexpr 



- arlthflietlc expression 
* avar] real {integer 

- avar subscript 
■ (aexpr) 

If parenthesea ^te ri^&ced more than 36 levels tiieept the 

TOUT OF MEMORY ptROR occurs. 
;. |+|-|HOt] a«xpr 

Unary NOT appears hetCj along with unary + and - 
!» aexpr op acupr 
:- aaxpr slop sexpr 



character 

:- letcerldlgitUpeclal 



Ctrl 



def 



:- hold down the key mrked "CTRL" while the 
fo'lloulng named key is pceeaed 



'■ deferred— execution fflode 



delimiter 

■•- -1<l)l-l-l+l*ri<IH/l.l:h 

A naioe does not have to be separated fron a preceding 
or Collowlng key word by any of these dell ulI t era. 



digit 



;- l|2|3K|5|6|7ie|D|* 



it m 

\t m 

(F m 

IP m 

tF' m 

[^ m 

(^. m 

(&- m 

It -a 

ib'-m 
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rr 

E 



expr 



fiam 



:- a press of the Escape key, oarked "ESC* 

expression 
;> aexpr^Bexpr 

:■ linDedlate>-executlon ckode 



lTiteg.er 



[^1-1 <<i£glt> 

Integers must be In the range -32767 through 
32767. When converting non-integers Into 
lotegera, APPLESOFT may be potiflideced to 
truncate the nCm-iRt eger to the next smaller 
integer. However, thjg 1b o&t quite true In 
the limit as the noo-lnteger apptoacheS the next 
larger integer. For instance: 



AJ - 123.999 999 959 999 

PRlHT Al 

123 

CX - 123il5.999 993 999 

PBlIiT Ct 

12345 



BX - 123.999 999 96 

PRINT BZ 

12i 

DX - 12345.999 996 

PRIBT DX 

[2346 



(Spaces added for easier reading) 

An array Integer occupies 2 bytea (16 bits) in memory. 

integer variable name 
:~ naaeS 

A real may %e stored ds an Integer variable, but 
APPLESOFT first converts the real to an integer. 

lectee 

i" Aisle |D|E|F|G|H|I|J|K|L|H|N|0|P|Q|R IS |T|U[V|V|X|Y|Z 

line 

1- linenuQ Klnscruction: )J instruction return 

Llnenun 

I ^ !ioc nuinber 

:- digit |{digit>| 

Line nuDobers oust be In the range [! to 63999 
or a ?S¥IfCAX ERROR aeasagc la displayed* 

literal 

:- [{character)] 

lowet-case letter 

:- afb|c|d|e|f lefh[iIj|k|l|ninJo|p|q|r|s|c|u|v|w[x|y|E 

:- {metasymbolXdlglt] 

14S 



fj 



netaeymWl 



Characters used in this docutneni: to itidicace 
various stmctures or relationships In 
APPLESOFT, but wliicti are not pare of the 
language 1c5q1C. 

- ii[iiMiM\r 

- lower-csee letter 

- a single digit cortcsteoateii to a mecanane 



;- letter [{letter Idlgic)! 

A name rady be up ca 23S characters in length. Uh@n 
dlstingulsblng. one name from another. APPLESOFT 
Ignores any alpVianumerld characters after the Elrat 
tKo- APPLESOFT does not dlatlnguish betweea the 
names GOODilLITTLE and GOLDRUSH. However, eveit the 
Ignored portion of a name nmst not contain a 
special or any ot APPLESOFT'b reserved vordo. 



:- real variable name 



It 

fF 
IF- 
IE 



naoeZ 



:- Integer variable pane 

name$ 

;■ String variable name 

null string 



IP 
IE 



op 



:- operator 
!- aopUlop 



prompt character 
:- 3 

The right bracket <!) la displayed when APPLESOFT 
is r@ady to accept a cciinrasnd. 



real 



l+l-l (digit) I.<dlgit>! [ E[+|-Idlgltldlgltl ) 
l+I-l Udlgit)!. Hdlgit)) [ El+|-)dt«lt[dieit] I 
The letter E, as used in real number tiotatiofi 
la form of "ecientiElC notation"), stands for 
"exponent." It ia. shorthand for *lfl" 
Ten Is raised to the power of the number on 
E'e right, and number on E's left la multiplied 
by the result. 

In APPLESOFT, reals must be in the range -l£38 
through lE3e qt yay risk the 70VERFL0H ERKOR 
message. Uslrsg addition or subtraction, you 
nay be able to generate redls as large aa 
1.7E3B without receiving thin nesaage. 
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it « 

e^ « 

E m 

E' m 



A real whose absolute value Is less than about 
2.93&3E-39 will be converted by APPLESOFT to 
zero. 

APPLESOFT recognizes the Collowlng as reals when 
preaenced by chemselvee, aod evaluates them as zeroi 



.E 



+.E 



-.E 



. E+ . E- +. E- +. E+ -. E+ -. E- 

The array element K(.} is the same as J^(0} 

In addition to the abbreviated teals listed above, 
Che following are recognized as reals and evalnated 
as zero when used as numeric responses to INPUT or 
aa numeric elements of DATA; 



E+ 



+E 



E- +E+ +E- 



-E 



-£+ 



space 



-E- 



The GET Instruction evaluates all of the single- 
character reala in the above lists ae zero- 

When printing a real numiber, APPLESOFT will show 
at most nine digits (see exception, helowji, 
excluding the exponent (If anyK Any further 
digits are rouo^Jed off- To the left of the decimal 
point, any zeros preceding; the leftmost nitn-teto 
digit are not printed. To the right of the decimal 
point, apy zeros follc«lng the rightmost non-zero 
digit are not printed. If there ate TO nOR-zero 

digits to the right of the tJeclfflal point, the 

decimal point is not printed. 

At the extreme limit, rounding Is sometimes curious: 

PRINT 99 999 999.9 

99 999 999.9 

raiHT 99 999 999.99 

100 090 000 

raiNT 11.111 111 451 9 
11.111 111 4 

PRI14T 11.111 111 A50 00 
11.111 111 3 

(Spaces added lor easier reading] 



147 



If a real's absolute value Is greater than or 
equal CO .{»l and Less Chan 999 999 999.2 Che 
real is printed In fiKed-poinc notation. 
That Is, no QJipanent Is d.lBpLayed< In the cang^ 
.19 L00 (J»0 Om 5 to .0 999 999 999 
reale are- printed with up to ten dibits-, 
including the zero ImmediaCely tn the right of ch& 
dacinal polnc. This ia the only exception to the 
Unit of nine printed digits, excluding th« 
exponent. 

If you attempt to use a real with more tlian 3& 
digits, such BB 

211. iiiiiiiiiiiHiiiiniiiLinnuiiii 

Eh^fi th« message 

TOVERFLOU ESRC« 

Is printed, even If the real Is clearly within 

Ctie tang^ — 1E3.8 through [!^3i8. Thf s is true even 

If most ai thii^ digits are trailing zeros, as In 

211. ianwmwwmiWiWiiiwiimwmm 

(•eadlng zeroes , bowpvc?r, are Ignored. If the flreC 
digit iB a one, and the Second digit is less than 
or er^ual CO six, nunbers with 39 digits may be 
used without getting an error message. 

A real oceuplee ^ bytes <4|t bits) In nemcry. 

real variable aa.me 
:« name 

reserved vord 

i" certairt groups of characters used by APPLESOFT to 
specify InBCrucClons or portions of inst ruccii>na. 
A name must not incLude a reserved word. Refer Co 
Appendix G for a list of APPLeSOPfB reserved 
words- 

reset 

:- a press of thf? key marked "RESET" 

return 

T- B press of the key marked "RETURN" 



Bexpr 



■ string expression 
- Bvar Istring 

■ acxpr sop sexpT 



slop 



sop 



:■ string logical operator 



:■ string operator 



rs 


'1 


t: 


'3 


Ic 


m 


tt- 


9 


11 


'^ 


(L 


^ 


[} 


3 


1? 


^ 


tE- 


m 


tEr 4 



SpECtSil 

:= Special symbol used by APPLESOFT II 
:- !|*|5|I|i|'|"ICI)|*|/n<|>|-|+|-|;UIJ.|3|?tJ 
Control characters (characters which are typed 
while holding down the CTRL key) and the null 
characer are also specials. The right bracket ( I ) 
can be typed on the APPLE keyboard, hut APPLESOFT 
u3ee It lor the prompt character only. In this 
document It is used as a metasymbol, 

subscript 

i- (aexpr({ ,aexpr>l ). 

The maxiraura number of dimensions (aexpr's) 
is S9, although Irt practice this is limited 
by the extent of nenory available, aexpr 
must be positive, and in use It Is 
converteii to an Integer. 



string 



Ma 



(E- m 

{E- a 

('- d 

(fe- 9 

tt-- -1 

t? a 

u a 

Ie- a 



"'HcliaracterU " 

A string occupies 2 bytes (16 bits) In memory 

for its location pointer, plus 1 byte (6 bits) 

for each character In the string. 
"[■{■eharacTerM reCyrn 

This form of the string can appear only 

at the end of a line. 



strlTig variable name 
.■ ■ naiae§ 



suring variable 

naae$|name$ subscript 
The location pointer and variable nanu each occupy 2 bytes 
in memory. The lengch and each string character occupy one byte. 



:- variable 

: ■ avar Isvar 

I ;~ metasymbol used to separate alternatives 

(note: an item nay also be defined separately 

for each alternative) 
I 1 r" tnetedyeibols used to enclose material which 

Is optional 
( > :- metasymbols used to^ enclose material which 

may be repeated 
\ :■ ntecasymbol used to enclose material whose 

value is to be used: the value of K 

is written \k\ 
:- metasymbol which indicates a required space 
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Appendix O: Summary of APPLESOFT Commands 






The inside back cover of this maiiudl contains an alphabetical Index 
directing you to the roore detailed deBcrlpcians of APPLESOFT ct^mmandB 
contained in CtiapteE9 3 through 10. 



ABS (-1.431) 

ReCuroB Che absolute value of the argument. 



The exanple recurna 3.i5L. 



arrow keys 

The keys marked with right and left ari-owe are used to edit APPlfiSOPT 
|iro6"iBB. The right-arrou kev novas the cursor to the tight; as it does, 
eacii charactet it crosses on the screen Is entered aa though you had typed 
ic. The lefc-arroM key ropuea the cursor ta th* leEt; as IE moveB, one 
character la eraeed frora the program line which you are currently typing, 
regardless of *At&t the cwrsor Is moving over. 



ASC("QUKST") 

Returns the decimal ASCII code for the first character in the aTgumeot. 

Che example, SI (ASCII for Q) will be returned. 



In 



A1 N i 2 ) 

Returns the arctangent. In radians, of the argument. 

Me714&72 <rsdlans> will be returned. 



In the exainple. 



CrM.T. -'*-- 

Causes execution of a mathioe-laagiiage auhtoutine fit Che toemory location 

whose decimal address ia specified. The exampLc wtil cau&e a line feed. 



ReturoB Che ASCII character that cotcesponds to the value of the argument, 
which must be between fl and Z55. The example returns the letter A. 



Sets all variables to zero and all Btringa to pull. 



Sets the color for plotting in lou-resolution graphics mode. In the 

example, color is set to green. Color is aet to sero by GR. Color namea 
and their associated numbers are 

black f* dark green B brown 12 green 

1 magenta 5^ grey 9 ofange 13 yellow 

2 dark blue 6 roediua felue Ifl grey U aqua 

3 purple 7 light blue H pink IS white 

To ilnd out ttie cplor at a given point on the scceeiii use Cha SCRH command. 



(t 


a 


it 


m 


E^a 


i€ 


m 


IE 


9 


(Er m 


It- 


m 


IE 


m 




m 


('• 


:S 


IE 


^ 


rr 


-a 


ffc 


4 


It 


« 



If program execution has been halted by STOP, EKD, ctrl C or reset {K 
return, the CONT connnand causes execution to resume at the next 
Instruction {like GOSUB) — not the next line number. Nothing ia 
cleared. After reset (IG retuco the progrsia rosy not CONTlnue properly 
because some program pointers fiTid stacks are cleared. CONT cnrniot be uaed 
if you have 

a) modified, added or deleted a program line, or 

b) gotten an error ncssage since stopping execution. 



Returns the COSlne of the argument, whicli must be in radians, 
example, -.41514bfi36 is returned. 



In the 



Can he us^d to interrupt a RUNnlng program or a LtSTlng> tc can also be 
used to Interrupt an IHI'tlT if it is the first character entered. The INPUT 
is not Interrupted until the RETURN ke^ Is pressed. 



Ctrl >: 

Tells the APPLE II to Ignore the lloe currently being typed, without 
deleting any previous line of Che same line number. A baeksla^It (\) L^ 
displayed at the end of Che line to be ignored. 



CreaCea a list of elements which can be used by READ ^cacenenta. In the 
eHample, the ffrst element is the literal JOHN SMITH; the second eletnenc la 
the string "CODE 32"j the third element la the real number 23.45; the fourth 
element la the integer -6. 

Allows uficr to define ^ne-llne ftmctions in a program. First the function 

must be defined using DEF; later In the pTOgrain the previously DEFined 

CuncCion may be used. The example illustrates bov to define a function 

FN A(U>; it may be yaed later lo the program in the form FN A<23) or 

FN A(-7*Q+i) art^ 60 On- FN A(23) will cause 23 to be substituted for H in 

2*W+W: the fuoctlan will cvalute to 2*23+23 or 69. Asaume q«Z; then 

FN A(-7*q+l) la equivalent to FN AC-7*2+l> or FS Af-U): the function Will 

evBluaCc Co 2*("i3)+(-l3) or -2b-13 or -39. 



ReoKiVea the specified range of lines from the program. In the example, 
lines 23 through 56 will be DELeted from the program. To DELece a single 
line. Bay line 358, use the fortn DEL 359, 35() or simply type ttie line number 
and then press the RETUkN key. 
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DIM AGE{Ztl,3li, MA>1KS(3V] 

When a DIM statement te executed. It sets aside space tor th* specified 
arrays wi Cti subiicclpts irfLDgitig from through the given subscripc* In Lhu 
example^ HAHESCSO) uiil be allotted ^fl+1 pr 51 strings o£ any lengthy the 
arcay AGE<2|il,3) will b* allotted [Z0+l)*(3+l> or 21*4 or 84 real nurabor 
eletnentsi 11 an array element is used in 9 pEagr^iQ before it is 
DlMenElaited, a maxlmuin fiubacrifit of 10 is aliloced Cor each dimension in the 
tlemenc's subscript. Array elemenca are set to zero when RUN or CLEAR are 
executed. 



dhm; >: AT =iti, 1^9 

Draws shape deEinltlc^n nimbeir l> ttoTn a previously loaded shape cable, In 

high-resolution graphics^ storting at x-5{l, y-lUfl. The color, rotation and 

scale of tbe shape to be drawn must have been epecified before DRAW is 

executed. 



Causes a progran to cease execution, and leturns control to the user. No 
neasage is printed. 



,.K ,\ or ■■-.. I a£ ■■■■«, ■ ■ I' 

The Escape key raay be used in tonjuncclort with the letter keys A or B or C 

or D to move the cursor uichout affecting the chacacterB iiK^ved over by the 

cur&at. To move the cursor ans space, E trst press the escape key^ then 

release the 'cs-cope key and press the appropi'iate letter key ■ 

c Q mna n d ooVea cursor one apace 

right 

left 

down 

up 



esc 


A 


esc 


B 


nsc 


C 


esc 


D 



Returns the value o£ e raised to the power Indicated by the Argument.. 
pLscee, eh2.71B.2&9i ao Ln the example 7.389tl561 will be returned. 



To 6 



Seta the video node to "Elashing", SO Che output from the computer Is 
alternately shown on the TV screen In white charactera on black and then 
reversed Co black chafacCere nn $ white background. Use NDRHAL to return to 
a non-flashing display of white letters on a black background. 



"iff ■.: = : -.1 :u ,.. njvXT w 

FOR Q-2 TO -3 STEP -2 ,,, ME)?! 

FOR Z-5 TO it STEP 3 ... NEXT 

Allows you to write a "loop" to perform a specified number of times any 

instruetiofiG between the FOR comc^nd (the top oi the loop] and the NEXT 

command (the bottom of the loop)- In the first example, the variable H 

counts how many times to do the IneCructlonsi the instructions inside Che 



i« 
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Loop ulll be exetuted for V eiqual to 1, 2, 3, ...20, chen the It^ap eada 
(with W-2n and the instruction after NEXT W Is enecuCcd. The second 
example illustrates how to indicate that the STEP size as you count Is to be 
different from It Checking takes place at Che end, of the loop, so in the 
third exainple, the instruct ions inside the loop ate executed once- 

Returns the amount of nemoTy, in bytes, still available to the user. Uhat 
you put inside the parentheses Is unimpDrtant, so long as it can be 
evaluated by APPLESOFT. 



GET ANS5 

Fetches a single character fmm the keyboard without showing it on Che TV 
screen and wlthouc requiring that the RETURN key be pressed, in the 
cxamplCr the typed character Is stored in the variable ^S$. 



(■-■.■. r - ^V 

Causes the program to branch to the indicated lii^e (25|J in tlie example). 
When a RETURN statement £s executed, Che program branches to the statement 
ImntsdJ^tely following the most recently SKecuEed GOSUB. 



• AW) :".« 

Causes the program to branch to the Indicated line (23d in the example). 

CR 

Sets low-cesolution C^aphics node <A0 by 40} for the TV screen, leaving four 
llnea £i>r tent at ihe bottom* The screen Is cleared to black, the cursor la 
moved into the text ulndfiw, and COLOR is set to 'i (blackji- 



Sets high-resoluclon graphics color to the color specified by HCOtflR- Color 

names and their associted values are 

(I blackl i. blackZ 

1 green (depends, on TV) b (depends on TV) 

2 blue (depends on TV) 6 {depends Pn TV) 

3 whltel 7 white2 



Only available In the firmware version of APPLESiJFt. Sets high-resolution 
graphics fqode {2S9 by 16(1) for the screen, leaving four lines for text at 
the bottom. The screen Is cleared to bliJclii and page L of raenory Is 
displayed. Neither HCOLOR nor text screen memory is affected when HGk Js 
eicecutedi The cursor is not moved Into the text window. 



Hi.V ? 

Seta full-screen hlgh-resolutlon gcapblcB mode (285t by 192). The screen Is 
t^leared to black and page 2 of memory la displayed- Ti^kC Screen memory Is 
not affected. 
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Sets the address oi the highest neoory location available to an APPLESOFT 
program, ln{:ludlng varlablea. It is used ro proCect an area o£ memory for 
data, hlgh-resoluCton gcreens or machine-language routines, HIMlHi iS floC 
reset by CL£AR» RVH, KiMt DEL, changlTig or adding a progrstn line, or reeett 

HLtS Id. 20 AT IJ 

Used to drew horizontal llnfcs In loM-reaolutlon B>^aphics mode, using the 
color most recently specified by COLOR. THe origin tx-fl and y-l*> for the 
eyscem ia the top leftmost dot of the screen. In the example, the line iti 
drawn from x-KP to x-Ifl at y-3(*. Another way to say ttiis: the line Is drawn 
from the dot (10,39) through the dot (2t»,30). 

HOKE 

Hovee the cursor to the upper left screen position wictiln the text wiTidaw^ 

and clears all text in the window. 

HP!OT 19. 29 

HFLDT 30, 40 70 54. 60 

HPLOT TO 70, 80 

Plots dots and lines in high-resoloclon graphics iBode using the most 

recently specified value of KCOLOR. The origin is the top leftmost screen 

dot (x'ffi y-<^)• The first exaaple plots a high-resolution dot at x-lp, 

^■20. The BGcond example plots a high-cesolutlon lltje from the dot at x-30» 

y"40 to the dot at x"50, y-60. The third example plots a line Ercm the Iflat 

dot plotted to the dot at x-70, y-90, using the color of the last dot 

plotted , not necessarily the aOBC recent HCOLOR, 

fiTAF' :'■' 

Moves the cursor either left or right to the specified column ^1 through ifl) 

on the screen. In the example, the cursor will be pcaltloned in eolunn 13. 



IF ANS$-"VeS" THEN GOTO 100 
IF WCHAX THEK 25 
IF NOIAX GOTO 25 

IE the enpression (ollowlng IF evaluates aa true (l.e» non-Eero>, then the 
instructlonts) following THEN in the same line will be executed. Otherwise, 
any Itistructlona following THEN are ignored, and execution passes to the 
instruction in the next nueihcrcd line of the program. String expreaBlona 
are evaluated by alphabetic ranking. Examples 2, 3 and 4 betiave the &ame, 
despite the different vordings. 

ITil'. 

INPUT "TYPE AGE THEN A COMMA TKEN NAME "; B. CS 

In the first example, INPUT prints a question mafk and watte for the user to 

type a Humbert which will be assigned to the integer variable AX< In the 



t 
t 

E 



1 




second example i INPUT prints the optional string exactly as shown, Chen 
waits for the user to type a number (which will be asEigned to the real 
variable B) then a comma, then string input (which will be assigned to the 
string variable CS). Multiple entries to INPUT may be separated by commaa 
or returns- 



■■;- ■';''rn 

Returns the largest integer less than or equal to the given argumeTiC. In 
the example. If flllH is 2.389, then 2 will be returned; if HUH is -^5, 1233A5 
then —46 will be returned. 



INVERSE 

Sets the video isode so that the computer's output prints aa black letters 

on a white background. Use NORMAL to return to white letters on a black 

background. 



Specifies the slot {from 1 through 7) of the peripheral which will be 
providing subsequent input for the computer. lUt re-establishes input 
from the keyboard Instead of the peripheral., 

Returns che specified numbet of IcfCWOSC characters from the string. In the 
example, AP?LE (the ^ leftmost charactera) will be returned. 



'..■ft .irr.iw 
See "airrow keys". 



\ ySi "A'l APt"! f .^ nav"\ 

Returns the number of characters in a string, between and 255. In the 

example, 14 will be returned. 

UI A ■ ..' ..' ■- 

AS • "DELICIOUS" 

The variable name to the left of - Is assigned the value of the string or 

expression to the right of the - . The LET is optional. 

LIST 2(10-3900 
LIST 200,3*00 
The first enaaiple causes the whole program to be dlaplayed on the TV ecreen; 

the second example causes program lines 200 through 3000 to be displayed. 
To list from the start of the program, through line 200, use LIST -200 ; to 
list from line 200 to the end of the proarao, use LtST 200- . The third 
example behaves the same as the second example. LlSTing is aborted by Ctrl 
C. 
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Reads an APPLESOFT program from cassette tape Into the computet'e memory. 
No prompt is given; the user must reuind the cape and pre^^ "play" on the. 
recorder before LOADing. A beep is sounded wlieti infofraatiofi Is found on the 
tape being LQADcd.- When LOADing la successfully completed, a second beep 
will sound and the APPLESOFT prorapc character (1 J will return. Only ceaet 
c&a iotercupt a LOAD* 



RetiirrB the natiital loBarithm of the speclEled ^rlt^metic expression, 
the example, .693147181 Is rettirned- 



In 



ldhiim: ■-' .' 

Sets the address of the lowest memory location available to a BASIC progrjin. 

This allows protection of variables from tilgh-resolutlon graphics In 
computere with large amounts d£ meinory. 

Mip':' ("^': v'M't '■ '. ^^^"', f. ^ 

HIPSC'AN APPLE A DAY", 4, 9) 

Returns fht specified substring. In the EltBt example, the fourth through 

the last characters of the string will be returned: APPLE A MY. In the 

second example, the nine characcers beginning with the fourth character In 

the string win be returned: APPLE A Q 



NKl. 



Deletes current program and all varlablesT 



See Che discussion of FOR. ..TO. ,, STEP- 



h 4 



Used to avoid Sn error message that ha Its execution when an error occurs. 
Uhen executed, QSERS. GOTO sets a. flag that causes an uncondlclonal jump to 
the: Indicated line number <34lil^ in the examplel if any error Is later 
encountered* 



I'DLl _U 

Returns th.e current value, a nuiaber f ron> 13 through 255, of ttie Indlceted 

game control paddle* Came paddle numbers through 3 are valid. 



Returns the contents, in decimal , of the byte at the specified decimal 
address (37 in the example). 



In lou-resolution graphics mode, places a dot at the speclEied location. In 
the enaraplE , the dot will be at k-10, y-2fl. The t-olo-r cif the doc Is 
determined by the most recent value of COLOR, which is Cblack) if not 
previously specified^ 

POKE -I63(»;, 1* 

Stores the binary equivalent of the second argument (4, in the example} Into 
the in^nory location whose decimal address Is given by the first argument 
(-163112, in the example}* 



Causes one RETURN address to "pop" off the top of the stack of RETUHll 
addresses- The next RETURN encountered after a PO? causes a branch co one 
Statement beyond the second most recently executed COSUB. 



Sets the Video fw^de to the usual white letters on e black bacicground for 
both Input and output. 



KOTW.V ( 

Turns off the TRACE mode. See TRACE. 



Executes a GOSUB to the line nuraber inillcated by the value t>f the arithmetic 
expression following OH. In the examplet if 10 la 1, COSUB [^i is executed; 
If ID la Z, GOSyB 20(» is executed, and so on. If the value oE the 
axptessJon is 9 or ia greater than the number of listed alternate line 
numbers, then pCOgrdtn execution proceeds to the next statement. 



ON ID COTO ltfl». .'MV, :\. '.Jfrl', .'; 

Identical to OS ID GOSUB (see above), but executes a COTO branching to the 

line number indicated by the value of the arithmetic expression Colloulnft 

ON. 
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Returns the current horizontal position of the cursor. This Is a number 
from 9 (at the left margin) to 39 (at the right margin). Wliat you put 
Inalde the parentheses is unimportant, so long as it can be evaluated by 
APPLESOFT. 



PRINT AS; "X - "; X 

The first example causes a line feed and return to be executed on the 

screen. Items in a list to be PRINTed should be separated by commas if each 

is to be displayed In a separate tab field. The Items should be separated 

by seml-colons if they are co be printed right nest to each other, without 

any intervening space. If A& contains "COKE" and X. is i, the second example 

will <!ause 

COR EX - J 

to be printed. 
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Transfers output Co the specified sl(JC» 1 through 7. PK# ceturne output 
to the TV screen. 



When executed, assigns the varlsbles ir the READ statement flutcesslvo values 
from elements in the program's DATA Btatements. In the example, the first 
tu<j eiements In the DA,TA Btatements must be nuTnbers, and the third a strlrg 
(which may be a nunber). They will be assigned, respectively, to the 
variables A, BX, and C$> 

H.ECAL1. MX 

Retrieves a real or an integer array which has been STOREd on cassette tape. 
An array inay be KECALLed with a different oame than used when It W5& STOREd 
on the tape. When BECALLed, MX coust have been Dimensioned by tbe program. 
Subst^fipts are not used wuh either 5TGRE or HEGALLi in the eK^mple, the 
fltray whose eletnents are HX(*), MX{1), ... vlll be retrlevedj Che 
subacrlptless variable MX will not be aSEected. No prompt or other elgnftl 
is given; you niust press "play" on the recorder when RECALL is executed; 
"beeps" signal the beginning and end of the recotded array. Only reeeC can 
interrupt a RECALL. 



Allowa text to be Insetted Irtto a program as remarks. 



repeat 

If you hold down the repeal key, labeled REPT, while pteasing any character 

key, the character will be tejieatedi 



u t <-T nil i-' 

Resets the "daca list pointer" to the first element of DATA. Causes the 
next READ statement encountered to re^EAD the DATA statements from Che 
first one- 



RESUME 

At the end of &ei error-haBdlina roucinc (see ONEBR goto), causes che 

resumption of the prograra at clie sTateneat in which the error i>ccurred. 



Branches to the atacement iwaedlately following Che most recently executed 
GOSLTB- 



BHli ( S > 

Returns a ranoum real number greater than or equal to (3 and less than i, 
RfttHV) returns Che most recently generated random number. Each negative 
argunienC generates a particular rsndox number that is the same every time 
HMD is used ulth that argumentv and subsequent RND's with positive 
arguments will always follow a particular, repeaCable aequence^ Every time 
RHP Is used with any positive argument^ a new raitdOAi number from to 1 la 
generatedi unless it is part cf a sequence of random nuTnbetS initiated by a 
negative air|;gs)ent- 

ROT - }ft 

Sets angular rotation for shape co drawn by DRAW or XDRAH. SOT-fl causes 

ehiflpe CO he DRAWn oriented Just as It was defined. R0T=i6 causes shape co 

be DRAUn rotated 99 degrees clockwise, etc. The process repeats etactlng at 

ROT-64. 

BUH 599 

Cleara all variables, pointers, and stacks and begins execution at the 
Indicated line nuraber (5;i(l In the exetnple). if no line number Is specified, 
execution begins at the lowest numbeired line in the program. 

SAVF- 

Stotes a program on cassette tape. Ho prompt or signal Is given: the user 
must press "record" and "play" an the recorder before SAVE is executed. 
SAVE doea not check that the proper recorder buttons are pushed; "beeps" 
signal the start and end of a recording. 

SCALE-Sy 

Sets scale size for shape to be draun by DRAU or XDRAU. SCALS'il s«cs point 
for point reproduction of che ahape definition. SCALE-25S results in each 
plotting vector being extended 255 times. NOTE: SCALE-() is maxlmlsi gl^e 
and not 9 single point. 

SCRN(10,20> 

In lov-resolucfon gcaphlcs mode, returns the color code of Che Specified 

point. In Che example, the color of the doc at k'IB^ y*2^ le returned. 



Returns -1 11 the argumenc la negative, fl if the argument is 
argunent Is positive. 



and 1 if the 



Returns the specified numher of rightmost ohaeactera from the string. 
the example, APPLE (the 5 rlfthcmost characters) will be recurned. 



In 



1 i^:iii .11 ■!>'<-■ 

See "arrow iKeys". 



IfiS 



Loads a shape tahle from cassette tape- Shape table is loaded just belou 
HIMEK: and then HIHEH: la set to just below the shape table co protect ic* 



Returns the sine of the arguaenc, which must be In radians. 
.9(19297427 is returned, 
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HuBt b« used in s mtUT statement* IntroduceB the specified number of 
spaces (8, in the example) betueco the last Item PRlNTed and the siext Item 
PRlHred if seml-coloTis pretede and follow the SPC cammand^ 

SPEED - 5« 

Sets rate at which characters are to be sent to the screen or other 

input/output devices. The alouest r&te Is fl; the fastest Is 255. 

Returns th* positive square root of the argutncnt ; in the example, i,41421JW 
is returned. SQR executes nuDre quickly than ~*3 

STOP 

Causes a prog.raia to •:sss-<; otccuclnn and display a mcHHage telling, ti'KiiC i Irte 

number contained the STOP. Cpntcpl of the coMputer is returned to the usetr 

STOKK nx 

Records an Integer or real artsy On tape. No prompt tnessage or other signal 
ia provided; the user must press "record" and "play" on the cecordi^r when 
STORE is executed- "Beeps" signal Che beginning and end of the recotdlrig. 
The Subscript of the arrray is not Indicated when STORE is used. In the 
example, the elements HX(B). MXil), 11X{2), ... are saved on the tapej the 
variable HX la noE affected- See RECALL. 
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Returna a String that represents the value of th« argument, 
the string "12.45" is rdCurnedi 



In the example , 



Cauaes the line number of each statement to be displayed an tihe screen as It 
is executed. TTIACE Is not turned off by BUN, CLEAR, NEW, DEL or reset. 
KOTRACE turns oH TRACE. 



ThSfi function passes its argument to a machine-langiiage aubroutine. The 
argument fs evaluated and put into clie floating-point accumulator (locations 
S9D through 5AS}, and a JSR to location S0A is performed. Locations ^BA 
through SK must contain a JHP to the beginning location of the 
machine-language subroutine. The return value for the functicn Is placed in 
the f loattng-poiint accumulator. To return ta APPLESOFT, do an RTS . 

VAl.r'-3.?K-VAi?LE"i 

AtCemptG to Interpret a string, up to the first non-numerfi' eharactcr. ae a 
f^al or an integer, and retuEHS the value of that numbpr ■ If no number 
occurs before the first non-nuaerlc character, a Is returned. In the 
example, -37a{10 is returned. 

VLIN la.JU AT Jff 

In low-reso!utloa graphics mode, drswa s vertical line In the color 
Indicated by the mast fecenl COIXtR stateiinent. The fine ia drawn in the 
coltiDin indicated by the third argument. In the example, the line is drawn 
ttoa y-l9 to y-2tf at x-3B. 

VTABdS) 

Hovea the cursor to the line on (he screen specified by the argument. The 
top line is line I; the bottow tine is line 2A. VTAB will cnove the cursor 
up or down but not left or right. 



TAUt23> 

Hij9i: be used in a PItENT fitatcnenc; the argument must be betii^cen 1 aind 255 
and enclosed In parentheses. For arguments I through 255, if the argument 
is greater than the value of the current cursor position. Chen TAB moves the 
cursor to the specified printing position, counting fTQm the left edge of 
the current cursor line. If Che argument is less than Che value of the 
current cursor posicioo, then the cursor is not moved. TABCO) puts the 
cursor into position 256. 



TAN (2) 

Returns the tangent ^f Chc argument, which must be in radians. In the 

example, -2.1S593967 Is returned. 



Sets the screen to the usual non-graphics teitc rn^de, uich ^0 characters per 
line and 24 lines. Also resets the text window to EuLl screen. 



1«0 



WAIT 16^^09. 255, 9 

Allows a conditional pause to be inserted into a program. The first 
argument is the decimal address of a beinory location to be tested to sec 
when certain bits are high <1, or on) and certain bits ure low (ff, or off). 
Each hit in the binary equivalent of the decimal second argument indicates 
whether you' re Interested in the corresponding bit In the memory location: 1 
means you're interested, 9 means ignore that bit- Each bit in the binary 
equivalent of the decimal third argument indicates which state you're 
UAlTlng for the corresponding bit in the memory location to he i(M I means 
the bit must be low, means the bit must be high. If no third argument is 
present, ia assumed. If any one of the bits indicated by a 1-blt in the 
second argument matches the state lor that bit indicated by the 
corresponding bit in the third argument, the WAIT Is over. 

>:i>KAH 1 Al \Hfi, \zt/ 

Drawa shape definition nunber 3 from a previously loaded shape Cable, In 
high-resolution graphics beginning at x-lBfl, y-120. For each pclnt plotted, 
the color is the complement of the color already existing nt chat point. 
Provides an easy way to erase: it you HJRAW a shape, then XDRAU it again, 
you'll erase the shape without erasing Che background, 
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ABS L(I2, 1S0 

Absolute value functlan: s^e ASS 

Accuracy in dl^iCS 4, b, 7, 18 

Address 40, 41, A3-45 

aexpc 3A. 13fi 

slop 23. 134 

AlpbiaTuimetic characcer 3|t, 134 

AND 33, 36, 144 

asp 33, 144 

APPLESOFT BASIC 

loading 146-109 
converting to 124, 125 
versuB Integer BASIC 142, 143 
in tirnMarc 44, 10&, 107, 109 
on cassette 106. 103, 109 

ArctaTigecit function: see ATN 

Arccoaecant function 103 

Accceslne fuocclOTi 103 

AcccotangenC Cunccion 103 

Arcseeant function 103 

Atcelne function 103 

Arithmetic operators 33, 36 

Arrays 14, 18, 32, 36 

iDecioiry al location IID 
aetnory map 126, 127 
STOKE. RECALL 62-64 
saving apace 118, 119 
zero page 140, 141 

Arrou keys 54, 55. 110-114. 150 

ASC 60, 150 

A$Cll character codes 13B 

Aesertlon 9 

Assignment statement 8 

Asterisk 2, 107 

AT t, Zb, &6. 98. 152, 154, 161 

ATN IS, 102, 123, 150 

avar ^i, 34, 144 



BASIC luadlng L06'^lif9 

Branchjoft 

GDSUB 15. 16, 79, 80, 1^3 

GOTO 76, 153 

loops 11-14, 78, 79 
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CALL 43. 52, 130, 134, 150 
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Cassette 








arrays 62-64 
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shape tables 97 








loading APPLESOFT 10b, 108 


r- 


n 


memory range 116 




Change program line 34, 


1 10-] 14 






Character 7, 30 








ASCII codes 138, 139 
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St 


SttiRgs 19-21, 59-61 








<im$ 60, 150 








CLEAJl 9-, 52, 150 
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41 


Colon 10, 125 








DATA 68 








GET 68 
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•4 


laPUT 66 








COLOR 5, 11, 24, 25, 85, 
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Color 23-27, 65. 89, 131 


"134 


|< 


Columns^ see tab fields 








Comma 

DATA 68 




t 


4 


GET 68 








INPUT 66 
PRINT 6. 70 
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Gotnraand 2, 122-123 








Concatenation 




r 


ac 


coflvercing co APPLESOFT ]2li 


PRINT 71 








SPC 52 
eCrings 21^ 71 
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COHT 39. 40, 67, 151 








Control character codes 


128 


II 
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Control B 106-188 




Contra! C 7. 10. 35, 39 


40, 






107-109, 151 
DATA 6B 
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GET 67 








INPUT 66 
LIST 40 
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Control H 67 








Control n 66, 69 
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Control X 35, 66, 69, 151 


Converting to APPLESOFT 


124, 123 






Cosecant function 103 




fe 
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COS 18, 102. E31 
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Cosine function: see CDS 
Cotangent function 103 
Ctrl (Conecol) 35, 144 
Cursor position 5iJ'-52, 34, 55, 
110-114. 131 



DATA 17, 68, 69, 141, 151 

I>eb\ig inodc 40 

Decintal placca IS, 22 

D^tiioal tokens for keywords 121 

DEF 18, 73, 74, 151 

Deferred execution 2, 36, 134 

DEL 49. 151 

Qelay loop 27, 41-43, 97 

Delete 3. 38, 49 

Delimiter 13, 144 

Qllferencee between APPLESOFT and 
Integer BAS^IC 142, 143 

Digits 4, 5. 18, 22 
real riufabecs 31-33 

DIM 14, 58, 152 

Dimensions: see DIH 

Division 2, 18, 33, 36 

DRAW 92, 97-99 

Dummy variable 73 



Editing 54, 55, na-ii4 

Element 

arrays 14, 32, 58, 62-64 

DATA 68, 69 
EtID 16, 39, lia. 152 
Equals sign 9, 12 
Erasing 

prograns 3. 38 

the Screen 52 
Error 115-117, 167 

ONNERRCOTO code type 81, 136 
ESC 35 

eec A, B, C. D 54, U0-114 

esc E, F !30 
Execution 2, 36. 38-45 
EXP 18, 103, 152 
Exponent 4. 5, 18, 31-33 
Enponent functlom aee EXP 
expr 35, 145 



Firmware APPLESOFT 106, 107, 109 

Fixed point notation 4 

FLASH 53, 152 

Floating point notatiori 4, 120, 141 

FN 73. 74, 151 

Format 4-5. 18, 22 

FOR. ..NEXT 11-L4, 20, 78. 79, 152 

Full screen graphics 84. 131-134 

Function 73, 1^2-104 

FRE 53, 153 



Came controls 90, 134, 135 

GET 24, 67, 153 

COSUB... RETURN 15. 16. 79, 80. 

U9. 1^3 
GOTO 7. 76. 81, 153 

program speed 120 
GR 5, 11, 23-25. 84, 131-134, 153 
Graphics 5, 10, 23-27, 83-100, 

126, 131-134 

H 

HCOLOB 26, 27, 89, 134, 153 

He»'-ideclmal codes 138, 139 

HCft 25, 26. 84. 87, 89, 98, 99, 

153 
K(;r2 25, 84, 88, 89, 99, 153 
High-reaolution graphics 25-27. 

87-100, 131-134 
memory range 126 
zero page 14| 
HIKQI: 41, 43, 44, 99, 100, 123, 

127. 154 

HLIH 6, 25, 86, 154 

HOME 11, 48. 52, 154 

HPLOT 2b, 89, 98, 131-134, 154 

HTAB 27. 50. 51, L54 

Hyperbolic function& 103. 104 



I 



IF... GOTO 76, 154 
1F...TH&N 9-10, 76. 154 
Imnediate i;xecutton 2, 36 
Incrementing In loopa L3, 78 
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INPUT 7, 9, 66, 67, Ul, IS/i 
lopuc/Output 38, 62-7A, 126 

gaTne controls and speaker 
99. 134-135 
In&erting 

pauses 4[, 42 

text 3, m, m 
IHT 19* 182, 155 
Integer 2, A 

cslf^ulatlons 3^6 

INT function 19, 102, ISS 

rounding l&, 31 

varUbleB 18, 31, 1A5 
Integer BASIC vers us APPLESOFT 

U2, U3 
Internal routipes IB, 182, lfl3, 

119 
InterruptlOLg execuElon 39, 4fl 
1HV£SSE 33, 155 

Inverse hyperbolic functions 1^9^ 
Inverse trigonometric functions 

142, 1^3 
IH* 71, 153 
Iteration U-U 

K 

Keyboard 139 
Keyvord codes 121 



LEFTS 28, b9, 124, 155 
Left-arfOU kty 54, 55, 67, 

II0-11A, 153 
LEB 19, 59, 155 
LET S, 12, 72, 155 
Line 2, 3. 36, 118, Kl 
Lines in gtaphlca node S6, &9, 92-97 
Line feed 79, 130 
tine number 2, 3, 35, 49, L45i 

byte slie 118 

DATA 6fi 

GOTO 75 

list itB 

ON...GOTQ SI 

zero page lifl 
llnenus] 33, 1^5 
LIST 3, 4, lt&, 15S 
LUtcral 19, 34, 145 

DATA 68, 69 

INPUT 66 

LET 72 



LOAD 38, 156 

Loading BASIC 196-109 

Logarithm function: see WG 

LOG IB, 103, 156 

LOMEM: l,f<, 45, 123, 127, 156 

LoDping n-14, 20; see FOR. . ^NEXT 

Liow-resoliiclofl gr^pblcs B4-S? 



M 



43, 



125 



SI 



124 



Machine language eubroutlnea 

45, 92-97 
Mantissa 4 

Margin settings 128, 129 
HAT convecBlon to APPLESOFT 
Matrix; see Array 
Memory 2, 8, 40, 41 

error message location 

HCR S7 

mRl 88 

EiBP 126, 127 

remaining 53 

storage allocation 119 

zero page 140, 141 
metanane 30, 145 
metasyrabols 30, 145 
HIDS 20, 61, 156 

converting to APPLESOFT 
MOD iH 
Modes 

debug ii9 

execution 36 
Monitor 

xnemory range 126, 127 

return to BASIC 107, 108 

shape tables 92-97 

Beto pa^e 1^0, 141 
HovtnB the cursor 50-52, 54, 55, 

U0''H4, 131 
Multiple statements per Line 

10, 125 
MltlelpJleation 2, 33, 36 

N 

name, nameX, naineS 31 , 33, 34, 146 

NEW 3, S, 38, 156 

NEXT 11-14, 20, 78, 79, 120, 156 

NORMAL 53. 156 

NOT 33, 34, 36 

NOTRACE 49, 156 



t 4 

I: 4 

f- < 

r < 

r- in 

F m 

F m 

F « 

F ig 

K- y 

I: 41 

t a 



Kutl string 19 
ASC 60 
DATA 69 
IF... THEN 
INPUT 66 
HIDS 61 
Number 4, 3, 
Number format 



76, 7 7 



8. 19, 31-33 

4, 5, la, 22, 31-33 



ON...GOSUB 81. 156 

ON. ..GOTO 81, 156 

ONERBCOTO 81, 136, 141, 157 

0^ 34, U6 

OR 33, 36 

Oucpuc, video modes 53 



Pause 27, 41-43, 97 

PDL 90, 157 

PEEK 4», 131, 134-136, 157 

Peripheral devices 71. 72. 90, 

126, 134, 135 

PLOT 5, 10, 24, 85, 157 

Plotting 5, 10, 11, 23-27, 34-100, 

131-134 
POKE 41, 48, 128, 129, L31-136, 
157 

Cull screen graphics 84, 87, 
8S, 131-134 
Pointers 38, 52, 69, 70, 8((, 126, 

127, 140, 141 
POP 80, 157 
POS 51, 157 

Precedence of operators 36 
Progradi 2 

zero page pointers 140, 141 
PRimr 2, 6, 7, 70, 71, 157 

strings 20, 21 

TAB 51 

SPC 52 
Proqpt character 35, 84, 106, 108 
PR* 72, 158 



Question nark 

INPUT 7, 66. 67 

PRINT 79 
Quotation mark 

DATA 69 

INPUT 66 

Strings 19, 34 



Randoin number function! see BUD 
READ 17. 66-70, 141, 153 
Real 4, 5, 31-33 

calculations 18, 36 

DATA 68, 6 9 

variable names IS, 33 
RECALL 62-64, 15S 

Relation between expressions 9, 36 
RHl 8, 10, 50, US, 158 
Repeat key fREPT) 55, 111-114. 158 
Replacing lines 3 
Beaerved words 7, 8, 38, 64, B7, 
148 

list 122-123 

storage allocation 119 
Reset 35, 39, 49 

KIHEH: 43, 44 

LOUEtl: 44 

RECALL 64 

RESUME 82 

stopping a program 39 

STORE 64 
RESTORE 17, 70, 158 
RESUME S2, 158 
return (RETURB key> 2, 3, 7, 35 

GET 68 

INPUT 66, 67 

PRINT 70 
RETURN 15, 16, 79, 80, 153 
RIGHTS 20, 61, 158 
Right-arrow key 54, 55, llfl-U4, 

I5iJ 
RND IB, 27, lfl2, 141. 159 
ROH-APPLESOFT lflt6, 107, 199 
ROT 92, 97-99 159 
Rounding 4. 5. 18, 19, 31-33 
RUN 2, a, 38, 39, 159 



SAVE 38, 159 

Savins program space 118-119 

SCALE 92. 97-99, 159 

Scientific notation A, 5 

SCRN S7, L59 

Secant 103 

BBxpr 35, 148 

Semi-colon 30. 33 

IKPUT 66, 67 

PRIBI fi, 70, 71 



164 
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SG^ 102, 139 

Shapes 92-103 

SHLOAD 92, 97-llia, 159 

Significant digits 5 

Sl:gTiuffl: see SCN 

SIN IS. I{»2, 159 

^laah 2, 36 

slop 35, i'lB 

Sloes thru 7 7i, 72 

sop 34, LAS 

Sorting 13, 23 

Space savers HR, 119 

SPC 52, 160 

Speaker 13A. 135 

Special symbols 30 

SFEED 5i. 160 

Speedins up the program 120 

SQR U-13, IS. £02, 160 

Square rooC function: see St^ 

STEP 13, 78, 152 

STOP 16, 39, 160 

StDfiplRg B. program 7, 10, 16. 39, 

39 
Storag.c allocation 119 
STCfflE 62-64. 160 
STKS 21, 22, 59t 169 
Scrings 18-23, 34 

ASC 60, 150 

CHR$ 60, 150 

cdncatenacion 21* 52, 71 

converting to APPLESOFT 
124, 125 

DATA 68, 69, L51 

iF...TH£N 76, 154 

INPUT 66, 67, 154, 155 

LEFTS 2ff, 60* 155 

LEH 19, 24, 59, 155 

LET 72. 155 

meinary 33, 119, 126, 127* U4, 
141 

Hia$ 20, 21, 61. 156 

oull strings 19, 60, 61, 67, 
f>9, 76. 77 

RECALL 62-6<., 158 

RIGHTS 20, 61, 15S 

STORE 62-64, 160 

SrR$ 21. 22, 59. [60 

substring 60, 61 

VAL 21, 23, 59. 161 
Subtoucine 16, 22, 79, 8* 
Subscript 14. 15, 34, 38 
Subatelng 60, 61 



svar 34. 149 

Syntactic deflnltionfi 3ff-36 
alphabetized 144-149 



lab 

fields 7ff, 71 

HTAB 50, 31 

TAB 51, 163 

VTAB 5fl 
TAH IS, 102, 160 
Tangent functioni aee TAN 
TEXT 6, 1 1, 64, 160 
Text 6, 24 

and graphics II, 131-134, 160 

nicwory range 126 

window 50, 51, 7B, 71, 84. 
128-130 
THEN: Bee IF... THEN 
TO: see KPLOT and GOTO 
Tokens for keywords 121 
TRACt 40, 82, 15L 
trigonometric functions 16, 1^2-104 



u 

USR 45, 161 



VAL 21. 23, 59, 161 

var 35 

VarlahlBB 7, 3, 31-35 

array 14. 38 

FOR. ..NEXT loops 12, 13, 78, 
79 

IBFlJT 7. 9, 66, 67. 71 

IntegCC IB, 19, 31 

LET ( - ) 8, 12. 14, 72, 73 

naius 7, 8, U, 18 31-35 

program speed L20 

READ, DATA 17, 68-7tf 

real 18 

saving space 118, L19 

string 16 

zero page 140, L41 
Vector 92-96 
Video output 33 
VLlB 6, 25, 66, 161 
VTAB 27, 50, 161 



t 4 

k 4 

Ik < 

» «( 

t- < 

r- < 

r- <c 

t_ « 

F m 

F- m 

K y 

t a 

t « 

--4. 
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w 

WAIT 41, 42, 161 

Uindou 50, 51, 70, 84, 128. 129 



XDRAW 92, 97-99, 161 
XPLOT 123 



Zero page 140, 14} 



ERROR MESSAGES 

?BAD SUBSCRIPT 117 

DIM 58 
TCAM'T CONTINUE 115 

com 40 

'DIVISION fl¥ ZERO 115 
r EXTRA IGNORED 

GET 66 

INPUT 67 
7F0RMULA TOO COMPLEX 116 

ir 77 

?1lleCai- direct IS5 

INPUT 67 
7ILLEGAL QUANTITY 115 
ASC 60 
CALl- S3 
CHRS 60 
DRAW 98 
HIKEH! 43 
HPLOT 89 
HTAB 50 
INl 72 
LEFT$ 60 
HIDS 61 
ON.,.COSUB SI 
ON... GOTO SI 
PDL 90 
PLOT 65 
POKE 41 
RIGHT $ 61 
SPC 52 
SPEED 54 
STORE, RECALL 62 
VLIN 86 
VTAB 50 
WAIT 41 



7NEXT WITHOUT FOR 116 

FOR 78 

NEXT 79 
TOUT OF DATA 116 

HtAD 7fl 

R6CALL 64 

STORE 64 
?Otrr OF MEMORY 116 

DIM 59 

GOS138 79 

UIHEH! 44 

iatfEHi 44 
10VERFL0U ERROR 116 

reals 33 

STRS 59 

VAL 59 
7REIHH'D AKRAY 116 

DIM 58 
?REENTER 

INPUT 66 
7RETURN HITHOUT GOSUB lib 

KETURH 80 
ISTRINC TOO LQKC ERHOR 116 

LEN 59 

PRINT 71 

VAL 59 
?SWTAX ERROR lU 

ASC 60 

CONT 40 

DATA 69 

DEL 49 

FOa-.-NEiTT 78, 79 

GET 68 

HGR 88 

HGR2 68 

IF... THEN 76, 77 

INPUT 67 

LIST 48 

RECALL 64 

RESUHE 82 

RUM 111 

SHLOAO 100 

STORE 64 

TEXT 64 
7TyPE HlSllATCH 117 

LEFT$ 60 

LET 73 

HID$ 61 

RIGHTS 61 
TUNDEF'D FUKCTIOII 117 

DEF 74 
?UMDEF'D STATEMENT 117 

GQSUB 79 

GOTO 76 

RUN 38 
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CAST OF CHARACTERS 

" 9, 30, ii, 6^, 67, fe9, 71 

$ 19, 3*. 34. 6fl. 61 

X 18, 3{», 3L 

* 2, 30, 36, 106 

+ ip, 5, 3#, 32. 36, 66, 68 

- 4, 5, 39, 32, 36, 66, &S 
, 2, 6, 3ff. 33. 66-71 

/ Z. 30, 33, 36, 125 

J 30, 33, 66-69 

; 6. 30, 33, 66, 67, 70, 71 

? 7, 30, 66, 7(1 

\ 30 

] vi. 30. 35. 106 

~ 30, 33, 36 

I 30 

~ 30, 33 

£} 14, 30. 33, 119 

II vll, 30 
(> vii, 30 

- aa aBSignoent 8, 12 

> as prompt charac tet 106 
-, >, < 9, 30, 33, 36 
& 123 
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